PvkPrivateKeyAcquireCoNtextFromMemory 函式

  • 發行項

重要

此 API 即將淘汰。 Microsoft 可能會在未來的版本中移除此 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 終止字串的指標，其中包含 dwProvType中要求其類型之 CSP 的名稱。

dwProvType [in]

CSP 類型的 DWORD 值。 如需 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