Page tree
Skip to end of metadata
Go to start of metadata

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

Синтаксис

    HANDLE GRD_API GrdCreateHandle(	
      HANDLE hGrd,
      DWORD dwMode,
      void *pReserved 
    );	
     Параметры функции

    hGrd

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

    dwMode

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

    pReserved

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

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

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

     Описание

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

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

    public static Handle GrdCreateHandle(GrdCHM Mode)
    
    
     Параметры метода

    Mode [in] 

    Тип: GrdCHM

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

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

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

    Тип: Handle

     Описание

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

     public static Handle GrdCreateHandle(GrdCHM Mode)
     Параметры метода

    Mode [in] 

    Тип: GrdCHM

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

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

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

    Тип: Handle

     Описание

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

     

     

     

     

     

     

    • No labels