SslGetProviderProperty 函式
SslGetProviderProperty函式會擷取指定提供者屬性的值。
語法
SECURITY_STATUS WINAPI SslGetProviderProperty(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_In_ LPCWSTR pszProperty,
_Out_ PBYTE ppbOutput,
_Out_ DWORD *pcbOutput,
_Inout_ PVOID *ppEnumState,
_In_ DWORD dwFlags
);
參數
-
hSslProvider [in]
-
安全通訊端層通訊協定的控制碼 (要擷取屬性的 SSL) 提供者。
-
pszProperty [in]
-
Null 終止 Unicode 字串的指標，其中包含要擷取的屬性名稱。
-
ppbOutput [out]
-
接收屬性值的緩衝區位址。
函式的呼叫端必須藉由呼叫 SslFreeBuffer 函式來釋放此緩衝區。
-
spOutput [out]
-
pbOutput緩衝區的大小，以位元組為單位。
-
ppEnumState [in， out]
-
VOID指標的位址，這個指標會接收此函式後續呼叫中使用的列舉狀態資訊。 此資訊只有 SSL 提供者的意義，而且對呼叫端不透明。 SSL 提供者會使用此資訊來判斷列舉中的下一個專案。 如果此參數所指向的變數包含 Null，則會從頭開始列舉。
函式的呼叫端必須藉由呼叫 SslFreeBuffer 函式來釋放此記憶體。
-
dwFlags [in]
-
這個參數保留給未來使用。
傳回值
如果函式成功，則會傳回零。
如果函式失敗，它會傳回非零錯誤值。
可能的傳回碼包括但不限於下列各項。
| 傳回碼/值 | 描述 |
|---|---|
|
記憶體不足，無法配置必要的緩衝區。 |
|
hSslProvider控制碼無效。 |
|
其中一個提供的參數無效。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2008 [僅限傳統型應用程式] |
| 標頭 |
|
| DLL |
|