Функция PvkGetCryptProv

  • Статья

Важно!

Это нерекомендуемый API. Корпорация Майкрософт может удалить этот API в будущих выпусках.

 

Функция PvkGetCryptProv получает дескриптор поставщика служб шифрования (CSP) на основе файла закрытого ключа или имени контейнера ключей.

Примечание

У этой функции нет связанного файла заголовка или библиотеки импорта. Чтобы вызвать эту функцию, необходимо создать определяемый пользователем файл заголовка и использовать функции LoadLibrary и GetProcAddress для динамического связывания с Mssign32.dll.

 

Синтаксис

HRESULT WINAPI PvkGetCryptProv(
  _In_      HWND       hwnd,
  _In_      LPCWSTR    pwszCaption,
  _In_      LPCWSTR    pwszCapiProvider,
  _In_      DWORD      dwProviderType,
  _In_      LPCWSTR    pwszPvkFile,
  _In_      LPCWSTR    pwszKeyContainerName,
  _Out_     DWORD      *pdwKeySpec,
  _Out_opt_ LPWSTR     *ppwszTmpContainer,
  _Out_     HCRYPTPROV *phCryptProv
);

Параметры

hwnd [in]

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

pwszCaption [in]

Указатель на строку, завершаемую null, для диалогового окна подпись.

pwszCapiProvider [in]

Указатель на строку, завершаемую null, для имени CSP.

dwProviderType [in]

Значение DWORD , представляющее тип поставщика шифрования. Дополнительные сведения см. в разделе Типы поставщиков служб шифрования.

pwszPvkFile [in]

Указатель на строку, завершающуюся значением NULL, которая содержит имя файла закрытого ключа.

pwszKeyContainerName [in]

Указатель на строку, завершаемую значением NULL, для имени контейнера закрытого ключа.

pdwKeySpec [out]

Указатель на значение DWORD для типа ключа контейнера, возвращаемого с помощью phCryptProv и ppwszTmpContainer.

ppwszTmpContainer [out, optional]

Адрес указателя на строку, завершаемую null, для имени контейнера временного ключа. Функция PvkGetCryptProv предоставляет и инициализирует временный контейнер. При вызове PvkGetCryptProv адрес должен указывать на значение NULL .

phCryptProv [out]

Указатель на дескриптор для CSP.

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

Если метод завершается успешно, он возвращает S_OK.

Если метод завершается сбоем, он возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Комментарии

Функция PvkGetCryptProv сначала пытается получить дескриптор поставщика из имени контейнера ключей, указанного параметром pwszKeyContainerName . Если передать значение NULL для параметра pwszKeyContainerName , PvkGetCryptProv попытается получить поставщика из файла закрытого ключа, указанного в параметре pwszPvkFile .

Завершив использование CSP, освободите дескриптор поставщика и контейнер временного ключа, вызвав функцию PvkFreeCryptProv .

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
DLL
Mssign32.dll