Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Deck of Cards
id001
Card
defaulttrue
labelC
Code Block
languagecpp
HANDLE GRD_API GrdCreateHandle(	
  HANDLE hGrd,
  DWORD dwMode,
  void *pReserved 
);	
Expand
titleПараметры функции

hGrd

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

dwMode

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

pReserved

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

Expand
titleВозвращаемое значение функции

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

Expand
titleОписание

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

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

Card
labelC#
Code Block
languagec#
public static Handle GrdCreateHandle(GrdCHM Mode)

Expand
titleПараметры метода

Mode [in] 

Тип: GrdCHM

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

Expand
titleВозвращаемое значение метода

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

Тип: Handle

Expand
titleОписание

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

Card
labelJava
Code Block
languagejava
 public static Handle GrdCreateHandle(GrdCHM Mode)
Expand
titleПараметры метода

Mode [in] 

Тип: GrdCHM

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

Expand
titleВозвращаемое значение метода

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

Тип: Handle

Expand
titleОписание

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

...