PvkGetCryptProv 函式

  • 發行項

重要

此 API 即將淘汰。 Microsoft 可能會在未來的版本中移除此 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]

CSP 名稱之 Null 終止字串的指標。

dwProviderType [in]

DWORD值，表示密碼編譯提供者類型。 如需詳細資訊，請參閱 密碼編譯提供者類型。

pwszPvkFile [in]

包含私密金鑰檔案名之 Null 終止字串的指標。

pwszKeyContainerName [in]

私密金鑰容器名稱之 Null 終止字串的指標。

pdwKeySpec [out]

使用phCryptProv和ppwszTmpContainer傳回之容器索引鍵類型的DWORD值指標。

ppwszTmpContainer [out， optional]

暫存金鑰容器名稱之 Null 終止字串的指標位址。 PvkGetCryptProv函式會提供並初始化暫存容器。 呼叫 PvkGetCryptProv時，位址應該指向 Null 值。

phCryptProv [out]

CSP 控制碼的指標。

傳回值

如果方法成功，它會 傳回S_OK。

如果方法失敗，它會傳回指出錯誤的 HRESULT 值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

備註

PvkGetCryptProv函式會先嘗試從pwszKeyContainerName參數所指定的金鑰容器名稱取得提供者控制碼。 如果您為pwszKeyContainerName參數傳遞Null，PvkGetCryptProv會嘗試從pwszPvkFile參數中指定的私密金鑰檔案取得提供者。

當您使用 CSP 完成時，請呼叫 PvkFreeCryptProv 函式來釋放提供者控制碼和暫存金鑰容器。

規格需求

需求 值
最低支援的用戶端
 Windows XP [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2003 [僅限桌面應用程式]
DLL
Mssign32.dll