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 |
|