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