共用方式為

SslOpenPrivateKey 函式

  • 發行項

SslOpenPrivateKey 函式會開啟私密金鑰的控制碼。

語法

SECURITY_STATUS WINAPI SslOpenPrivateKey(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_KEY_HANDLE  *phPrivateKey,
  _In_  PCCERT_CONTEXT     pCertContext,
  _In_  DWORD              dwFlags
);

參數

hSslProvider [in]

安全通訊端層通訊協定的控制碼 (SSL) 通訊協定提供者實例。

phPrivateKey [out]

要在其中將控制碼寫入私密金鑰的緩衝區位址。

當您使用完金鑰時，應該藉由呼叫SslFreeObject函式來釋放phPrivateKey。

pCertCoNtext [in]

要從中取得私密金鑰的憑證位址。

dwFlags [in]

這個參數保留給未來使用。

傳回值

如果函式成功，則會傳回零。

如果函式失敗，它會傳回非零的錯誤值。

可能的傳回碼包括但不限於下列專案。

傳回碼/值 Description
NTE_NO_MEMORY
0x8009000EL
 記憶體不足，無法配置必要的緩衝區。
NTE_INVALID_HANDLE
0x80090026L
 hSslProvider控制碼無效。
NTE_INVALID_PARAMETER
0x80090027L
 phPrivateKey或pCertCoNtext參數為Null。

備註

取得的私密金鑰是憑證內公開/私密金鑰組的一部分。 此函式只會從 pCertCoNtext 參數所指定的憑證擷取私密金鑰。

規格需求

需求 值
最低支援的用戶端
 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 [僅限傳統型應用程式]
標頭
Sslprovider.h
DLL
Ncrypt.dll