Функция(метод) GrdCreateHandle создает защищенный контейнер.

Синтаксис

HANDLE GRD_API GrdCreateHandle(	
  HANDLE hGrd,
  DWORD dwMode,
  void *pReserved 
);

hGrd

указатель на область памяти, зарезервированной для защищенного контейнера

dwMode

режим работы контейнера в многопоточной среде. Начиная с версии 6.31 этот параметр игнорируется и должен быть равен константе GrdCHM_MultiThread.

Всегда используется режим одновременной работы из нескольких потоков.

GrdCHM_SingleThread	Контейнер создается для работы в монопольном режиме
GrdCHM_MultiThread	Контейнер может быть использован для одновременной работы с ним из нескольких потоков

pReserved

зарезервировано. Параметр pReserved должен быть равен NULL

Хэндл защищенного контейнера. Если hGrd был задан равным NULL, то есть функция должна была зарезервировать память для контейнера самостоятельно, а в процессе создания защищенного контейнера возникла ошибка, функция вернет NULL.

Если hGrd равен NULL, то функция выделяет динамическую память для создания контейнера. В противном случае контейнер будет размещен в памяти по тому адресу, который указан в параметре hGrd. Размер этого блока памяти во избежание ошибок должен быть не меньше значения константы GrdContainerSize.

При создании защищенного контейнера, внутри API создается критическая секция, через которую происходит синхронизация обращений к ключу из разных потоков. Использовать режим многопоточности рекомендуется только в тех случаях, когда работа с ключом действительно будет производиться из нескольких потоков. В остальных случаях следует создавать защищенный контейнер для использования ключа в монопольном режиме.

public static Handle GrdCreateHandle(GrdCHM Mode)

Mode [in]

Тип: GrdCHM

режим создания контейнера - монопольный или многопоточнный

Хэндл защищенного контейнера.

Защищённый контейнер всегда создаётся в динамической памяти. При создании защищенного контейнера, внутри API создается критическая секция, через которую происходит синхронизация обращений к ключу из разных потоков.

 public static Handle GrdCreateHandle(GrdCHM Mode)

Mode [in]

Тип: GrdCHM

режим создания контейнера - монопольный или многопоточнный

Хэндл защищенного контейнера.

Защищённый контейнер всегда создаётся в динамической памяти. При создании защищенного контейнера, внутри API создается критическая секция, через которую происходит синхронизация обращений к ключу из разных потоков.