XGameSaveEnumerateBlobInfoByName

접두사를 blobNamePrefix 매개 변수와 공유하는 blob로 제한된 XGameSaveContainer의 콘텐츠에 대해 blob 정보를 검색합니다.

구문

HRESULT XGameSaveEnumerateBlobInfoByName(  
         XGameSaveContainerHandle container,  
         const char* blobNamePrefix,  
         void* context,  
         XGameSaveBlobInfoCallback* callback  
)  

매개 변수

container _In_
형식: XGameSaveContainerHandle

열거할 blob이 포함된 XGameSaveContainer에 대한 핸들입니다.

blobNamePrefix _In_opt_z_
형식: char*

검색된 blob을 필터링하는 데 사용하는 접두사입니다.

context _In_opt_
형식: void*

컨텍스트에 대한 호출 개체의 포인터입니다.

callback _In_
형식: XGameSaveBlobInfoCallback*

접두사와 일치하는 모든 blob에 대해 호출할 함수입니다. 열거를 중지하려면 false를 반환합니다. 이를 사용하여 XGameSaveBlobInfo를 반복하고 함수 호출이 성공하는지 확인합니다.

반환 값

형식: HRESULT

함수 결과입니다.

설명

참고 항목

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지만 XGameSaveBlobInfoCallback은 타이틀이 콜백 내에서 수행하는 작업에 따라 지연을 일으킬 수 있습니다. 예를 들어 콜백에서 데이터를 복사하는 것은 괜찮지만 시간이 아닌 호출을 수행하면 콜백 반환이 지연됩니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.

Blob은 컨테이너를 구성하는 실제 검색 가능한 데이터를 포함합니다. blob을 열거하면 컨테이너 내부에서 사용 가능한 모든 데이터를 볼 수 있습니다. 접두사로 필터링하는 대신 XGameSaveEnumerateBlobInfo를 사용하여 컨테이너의 모든 blob을 열거할 수 있습니다.

요구 사항

헤더: XGameSave.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XGameSave
XGameSaveBlobInfo
XGameSaveEnumerateBlobInfo
게임 저장 오류