SslGetKeyProperty 函式

SslGetKeyProperty函式會擷取安全通訊端層通訊協定的具名屬性值， (SSL) 提供者金鑰組象。

語法

SECURITY_STATUS WINAPI SslGetKeyProperty(
  _In_  NCRYPT_KEY_HANDLE hKey,
  _In_  LPCWSTR           pszProperty,
  _Out_ PBYTE             ppbOutput,
  _Out_ DWORD             *pcbOutput,
  _In_  DWORD             dwFlags
);

參數

hKey [in]

SSL 提供者的控制碼。

pszProperty [in]

Null 終止 Unicode 字串的指標，其中包含要擷取的屬性名稱。 這可以是其中一個預先定義的金鑰儲存體屬性識別碼或自訂屬性識別碼。

ppbOutput [out]

接收屬性值之緩衝區的指標。 函式的呼叫端必須呼叫 SslFreeBuffer 函 式來釋放此緩衝區。

spOutput [out]

pbOutput緩衝區的大小，以位元組為單位。

dwFlags [in]

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

傳回值

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

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

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

傳回碼/值	描述
NTE_INVALID_HANDLE 0x80090026L	其中一個提供的控制碼無效。
NTE_INVALID_PARAMETER 0x80090027L	其中一個提供的參數無效。

規格需求

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