Skip to main content

XGameStreamingGetSessionId

이 API는 지정한 클라이언트의 스트리밍 세션을 고유하게 식별하는 null 종료 불투명(opaque) 문자열을 반환합니다.

구문

매개 변수

client   _In_
형식: XGameStreamingClientId
쿼리 대상 스트리밍 클라이언트입니다. sessionIdSize   _In_
형식: size_t
sessionId 버퍼의 크기입니다. sessionId   _Out_writes_bytes_to_(sessionIdSize, *sessionIdUsed)
형식: char*
지정한 클라이언트의 세션 ID로 채워질 버퍼입니다. sessionIdUsed   _Out_opt_
형식: size_t*
sessionId 버퍼에 반환된 값의 크기(바이트 단위이며, null 종료 문자 포함)입니다.

반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

잠재적 오류

오류 코드 목록은 오류 코드를 참조하세요.

설명

sessionId에 기록되는 문자열은 SessionIdMaxBytes보다 커지지 않으므로 미리 할당할 수 있습니다. sessionId의 레이아웃/내용은 향후 변경될 수 있으므로 불투명한 문자열로만 해석해야 합니다. 다른 클라이언트 속성 API와 마찬가지로, sessionId의 변경 사항을 알리는 콜백을 등록하려면 XGameStreamingRegisterClientPropertiesChanged를 사용하는 것이 좋습니다.

예제

요구 사항

헤더: xgamestreaming.h
라이브러리: xgameruntime.lib
지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

함께 보기

XGameStreaming XGameStreamingRegisterClientPropertiesChanged
마지막 수정일 2026년 8월 24일