TLSGetServerCertificate 函式
傳回遠端桌面授權伺服器的憑證。
注意
此函式沒有相關聯的標頭檔或匯入程式庫。 若要呼叫此函式，您必須建立使用者定義的標頭檔，並使用 LoadLibrary 和 GetProcAddress 函式動態連結至Mstlsapi.dll。
語法
DWORD WINAPI TLSGetServerCertificate(
_In_ TLS_HANDLE hHandle,
_In_ BOOL bSignCert,
_Out_ LPBYTE *ppbCertBlob,
_Out_ LPDWORD lpdwCertBlobLen,
_Out_ PDWORD pdwErrCode
);
參數
-
hHandle [in]
-
處理由 TLSConnectToLsServer 函式呼叫所開啟的遠端桌面授權伺服器。
-
bSignCert [in]
-
如果 簽章憑證為 TRUE ，則為 FALSE，如果交換憑證則為 FALSE。
-
ppbCertBlob [out]
-
接收包含憑證之緩衝區指標的變數指標。
-
lpdwCertBlobLen [out]
-
接收所傳回憑證大小的變數指標。
-
pdwErrCode [out]
-
接收錯誤碼之變數的指標。
-
LSERVER_S_SUCCESS (0)
-
呼叫成功。
-
TLS_W_SELFSIGN_CERTIFICATE (4007)
-
傳回的憑證是自我簽署憑證。
-
TLS_W_TEMP_SELFSIGN_CERT (4009)
-
傳回的憑證是暫時的。
-
TLS_E_ACCESS_DENIED (5003)
-
拒絕存取。
-
TLS_E_ALLOCATE_HANDLE (5007)
-
伺服器太忙碌，無法處理要求。
-
TLS_E_NO_CERTIFICATE (5022)
-
無法擷取憑證。
傳回值
此函式會傳回下列可能的傳回值。
-
RPC_S_OK
-
呼叫成功。 檢查 pdwErrCode 參數的值，以取得呼叫的傳回碼。
-
RPC_S_INVALID_ARG
-
此引數無效。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| DLL |
|