Функция PvkPrivateKeyAcquireContextFromMemory

  • Статья

Важно!

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

 

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

Примечание

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

 

Синтаксис

BOOL WINAPI PvkPrivateKeyAcquireContextFromMemory(
  _In_        LPCWSTR    pwszProvName,
  _In_        DWORD      dwProvType,
  _In_        BYTE       *pbData,
  _In_        DWORD      cbData,
  _In_        HWND       hwndOwner,
  _In_        LPCWSTR    pwszKeyName,
  _Inout_opt_ DWORD      *pdwKeySpec,
  _Out_       HCRYPTPROV *phCryptProv,
  _Out_       LPTSTR     *ppwszTmpContainer
);

Параметры

pwszProvName [in]

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

dwProvType [in]

Значение DWORD для типа CSP. Дополнительные сведения о типах CSP см. в разделе Типы поставщиков шифрования.

pbData [in]

Указатель на буфер для получения данных контекста. Вызывающий объект должен предоставить этот ресурс.

cbData [in]

Значение DWORD , указывающее размер буфера pbData в байтах. Вызывающий объект должен предоставить это значение.

hwndOwner [in]

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

pwszKeyName [in]

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

pdwKeySpec [in, out, optional]

Указатель на значение DWORD , указывающее тип ключа. Возможные значения: AT_KEYEXCHANGE или AT_SIGNATURE.

phCryptProv [out]

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

ppwszTmpContainer [out]

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

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

После успешного выполнения эта функция возвращает значение TRUE. Функция PvkPrivateKeyAcquireContextFromMemory возвращает значение FALSE в случае сбоя.

Требования

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