Skip to main content

XNetworkingVerifyServerCertificate

Fornece validação adicional da cadeia de certificados.

Sintaxe

Parâmetros

requestHandle   _In_
Tipo: void*
Um identificador do tipo HINTERNET. Para obter um identificador válido, chame WinHttpOpenRequest. securityInformation   _In_
Tipo: XNetworkingSecurityInformation*
Ponteiro para uma estrutura XNetworkingSecurityInformation. Para obter um ponteiro apropriado, chame a função XNetworkingQuerySecurityInformationForUrlAsyncResult.

Valor retornado

Tipo: HRESULT Retorna S_OK se for bem-sucedida. Isso indica que a cadeia de certificados do servidor é válida. Caso contrário, retorna um código de erro indicando que não foi possível validar a cadeia do servidor. Trate todas as falhas como fatais para a solicitação HTTP.

Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, confira Threads sensíveis ao tempo.
Chame esta função de dentro do retorno de chamada WINHTTP_CALLBACK_STATUS_SENDING_REQUEST do WinHTTP. Passe uma estrutura XNetworkingSecurityInformation armazenada em cache de uma chamada anterior para XNetworkingQuerySecurityInformationForUrlAsync junto com o identificador de solicitação WinHTTP associado ao retorno de chamada. Para obter informações adicionais sobre o retorno de chamada, confira WinHttpSendRequest. Se a função XNetworkingVerifyServerCertificate falhar, provavelmente o runtime de jogos detectou uma conexão comprometida com o servidor. Nesse caso, você deve fechar imediatamente o identificador de solicitação WinHTTP antes que o retorno de chamada retorne, para garantir que nenhum dado seja transferido de ou para o servidor comprometido. Como prática recomendada, toda a comunicação do título, independentemente do conteúdo ou protocolo, deve ser protegida. Um título deve fornecer confidencialidade, integridade e autenticação para toda a comunicação do título. Para obter mais informações, confira Visão geral da segurança de comunicação (tópico sob NDA)

Requisitos

Cabeçalho: XNetworking.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

HTTP e WebSockets
XNetworking
Last modified on October 6, 2026