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	Mstlsapi.dll

另请参阅

TLSConnectToLsServer