Função TLSGetServerCertificate

Retorna o certificado do servidor de licença da Área de Trabalho Remota.

Observação

Essa função não tem nenhum arquivo de cabeçalho associado ou biblioteca de importação. Para chamar essa função, você deve criar um arquivo de cabeçalho definido pelo usuário e usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Mstlsapi.dll.

Sintaxe

DWORD WINAPI TLSGetServerCertificate(
  _In_  TLS_HANDLE hHandle,
  _In_  BOOL       bSignCert,
  _Out_ LPBYTE     *ppbCertBlob,
  _Out_ LPDWORD    lpdwCertBlobLen,
  _Out_ PDWORD     pdwErrCode
);

Parâmetros

hHandle [in]

Manipule para um servidor de licença da Área de Trabalho Remota que é aberto por uma chamada para a função TLSConnectToLsServer .

bSignCert [in]

TRUE se certificado de assinatura, FALSE se trocar certificado.

ppbCertBlob [out]

Ponteiro para uma variável que recebe um ponteiro para um buffer que contém o certificado.

lpdwCertBlobLen [out]

Ponteiro para uma variável que recebe o tamanho do certificado retornado.

pdwErrCode [out]

Ponteiro para uma variável que recebe o código de erro.

LSERVER_S_SUCCESS (0)

A chamada foi bem-sucedida.

TLS_W_SELFSIGN_CERTIFICATE (4007)

O certificado retornado é um certificado autoassinado.

TLS_W_TEMP_SELFSIGN_CERT (4009)

O certificado retornado é temporário.

TLS_E_ACCESS_DENIED (5003)

Acesso negado.

TLS_E_ALLOCATE_HANDLE (5007)

O servidor está muito ocupado para processar a solicitação.

TLS_E_NO_CERTIFICATE (5022)

Não é possível recuperar um certificado.

Valor retornado

Essa função retorna os seguintes valores de retorno possíveis.

RPC_S_OK

A chamada foi bem-sucedida. Verifique o valor do parâmetro pdwErrCode para obter o código de retorno da chamada.

RPC_S_INVALID_ARG

O argumento era inválido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
DLL	Mstlsapi.dll

Confira também

TLSConnectToLsServer