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