Структура VTableProvStruc

Структура VTableProvStruc содержит указатели на функции обратного вызова, которые могут использоваться функциями поставщика служб шифрования (CSP).

Синтаксис

typedef struct VTableProvStruc {
  DWORD   Version;
  FARPROC FuncVerifyImage;
  FARPROC FuncReturnhWnd;
  DWORD   dwProvType;
  BYTE    *pbContextInfo;
  DWORD   cbContextInfo;
  LPSTR   pszProvName;
} VTableProvStruc, *PVTableProvStruc;

Члены

Версия

Значение DWORD , указывающее версию структуры. Используются три версии этой структуры. Версии являются номерами 1, 2 и 3 и определяют, какие элементы структуры являются допустимыми. Элементы версии 1 действительны во всех системах, поддерживающих эту структуру.

Это член версии 1.

FuncVerifyImage

Адрес функции обратного вызова FuncVerifyImage , которую CSP использует для проверки подписи всех библиотек DLL, которые будет загружать CSP. Все вспомогательные библиотеки DLL, в которые CSP выполняет вызовы функций, должны быть подписаны тем же способом (и с тем же ключом), что и основная библиотека DLL CSP. Чтобы обеспечить эту сигнатуру, вспомогательные библиотеки DLL должны загружаться динамически с помощью функции LoadLibrary . Но перед загрузкой библиотеки DLL необходимо проверить подпись библиотеки DLL. CSP выполняет эту проверку, вызывая функцию FuncVerifyImage , как показано в примере ниже.

Этот указатель функции можно хранить и использовать до освобождения контекста CSP.

Это член версии 1.

FuncReturnhWnd

Адрес функции обратного вызова FuncReturnhWnd , которая возвращает дескриптор окна, который CSP должен использовать в качестве родительского или владельца любого отображаемого пользовательского интерфейса. Поставщики служб конфигурации, которые не взаимодействуют напрямую с пользователем, и CSP, использующие специальное оборудование для этой цели, могут игнорировать эту запись. По умолчанию этот дескриптор окна равен нулю, но приложение может задать другое значение с помощью функции CryptSetProvParam для задания свойства PP_CLIENT_HWND .

Этот указатель функции можно хранить и использовать до освобождения контекста CSP.

Это член версии 1.

dwProvType

Значение DWORD , указывающее тип поставщика для получения. Следующие типы поставщиков являются предопределенными и подробно рассматриваются в разделе Взаимодействие CSP:

• PROV_RSA_FULL
• PROV_RSA_SIG
• PROV_DSS
• PROV_FORTEZZA
• PROV_MS_EXCHANGE

Это член версии 2.

pbContextInfo

Указатель на массив контекстных сведений. Вместе члены pbContextInfo и cbContextInfo определяют набор данных, используемый при вызове функции CPSetProvParam с PP_CONTEXT_INFO набором.

Это член версии 2.

cbContextInfo

Значение DWORD , указывающее количество элементов в массиве pbContextInfo .

Это член версии 2.

pszProvName

Строка, содержащая имя поставщика.

Это член версии 3.

Комментарии

Указатели в структуре VTableProvStruc доступны только в функции CPAcquireContext . Если члены структуры необходимы после вызова CPAcquireContext , поставщик служб конфигурации должен создать копии необходимых элементов структуры. Указатели функций в этой структуре можно хранить и использовать до освобождения контекста CSP.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Cspdk.h
Имя в кодировке Юникод и ANSI	VTableProvStrucW (Юникод)