Skip to main content

XNetworkingVerifyServerCertificate

Proporciona una validación adicional de la cadena de certificados.

Sintaxis

Parámetros

requestHandle   _In_
Tipo: void*
Identificador de tipo HINTERNET. Para obtener un identificador válido, llame a WinHttpOpenRequest. securityInformation   _In_
Tipo: XNetworkingSecurityInformation*
Puntero a una estructura XNetworkingSecurityInformation. Para obtener un puntero adecuado, llame a la función XNetworkingQuerySecurityInformationForUrlAsyncResult.

Valor devuelto

Tipo: HRESULT Devuelve S_OK si se realiza correctamente. Esto indica que la cadena de certificados del servidor es válida. De lo contrario, devuelve un código de error que indica que no se pudo validar la cadena del servidor. Trate todos los errores como fatales para la solicitud HTTP.

Comentarios

No es seguro llamar a esta función en un subproceso con restricciones de tiempo. Para obtener más información, consulte Subprocesos con restricciones de tiempo.
Llame a esta función desde dentro de la devolución de llamada de WinHTTP WINHTTP_CALLBACK_STATUS_SENDING_REQUEST. Pase una estructura XNetworkingSecurityInformation almacenada en caché de una llamada anterior a XNetworkingQuerySecurityInformationForUrlAsync junto con el identificador de solicitud de WinHTTP asociado a la devolución de llamada. Para obtener información adicional sobre la devolución de llamada, consulte WinHttpSendRequest. Si la función XNetworkingVerifyServerCertificate produce un error, es probable que el entorno de ejecución de juegos haya detectado una conexión en peligro con el servidor. En este caso, debe cerrar inmediatamente el identificador de solicitud de WinHTTP antes de que la devolución de llamada se devuelva para asegurarse de que no se transfiera ningún dato hacia o desde el servidor en peligro. Como procedimiento recomendado, toda la comunicación del título, independientemente del contenido o el protocolo, debe protegerse. Un título debe proporcionar confidencialidad, integridad y autenticación para toda la comunicación del título. Para obtener más información, consulte Información general sobre la seguridad de las comunicaciones (tema con NDA)

Requisitos

Encabezado: XNetworking.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

HTTP y WebSockets
XNetworking
Última modificación el 28 de agosto de 2026