XNetworkingVerifyServerCertificate
추가 인증서 체인 유효성 검사를 제공합니다.
구문
HRESULT XNetworkingVerifyServerCertificate(
void* requestHandle,
const XNetworkingSecurityInformation* securityInformation
)
매개 변수
requestHandle _In_
형식: void*
HINTERNET 형식의 핸들입니다. 유효한 핸들을 얻으려면 WinHttpOpenRequest를 호출합니다.
securityInformation _In_
형식: XNetworkingSecurityInformation*
XNetworkingSecurityInformation 구조체에 대한 포인터입니다. 적절한 포인터를 얻으려면 XNetworkingQuerySecurityInformationForUrlAsyncResult 함수를 호출합니다.
반환 값
형식: HRESULT
성공하면 S_OK(이)가 반환됩니다. 이는 서버 인증서 체인이 유효하다는 것을 나타냅니다. 그렇지 않다면 서버 체인을 확인할 수 없다는 것을 나타내는 오류 코드가 반환됩니다. 모든 실패는 HTTP 요청에 치명적인 것으로 처리됩니다.
비고
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
이 함수는 WINHTTP_CALLBACK_STATUS_SENDING_REQUEST WinHTTP 콜백에서 호출해야 합니다. 이전 호출의 캐시된 XNetworkingSecurityInformation 구조를 콜백과 관련된 WinHTTP 요청 핸들과 함께 XNetworkingQuerySecurityInformationForUrlAsync로 전달합니다. 콜백에 대한 자세한 내용은 WinHttpSendRequest를 참조하세요.
XNetworkingVerifyServerCertificate 함수가 실패한다면, 게임 런타임이 서버와의 연결 손상을 감지할 확률이 높습니다. 이 경우에는 콜백이 반환되기 전에 WinHTTP 요청 핸들을 즉시 닫아, 손상된 서버와 데이터를 주고받지 않게 해야 합니다.
모든 타이틀 통신은 통신의 콘텐츠 및 프로토콜에 상관없이 반드시 보호해야 합니다. 타이틀에서는 모든 타이틀 통신에 기밀성, 무결성 및 인증 기능을 제공해야 합니다. 자세한 내용은 통신 보안 개요(NDA 항목)권한 부여 필요를 참조하세요.
요구 사항
헤더: XNetworking.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔