IWMDMStorage4::FindStorage 메서드(mswmdm.h)

아티클
03/05/2024

FindStorage 메서드는 영구 고유 식별자를 기반으로 현재 루트 스토리지의 스토리지를 검색합니다.

구문

HRESULT FindStorage(
  [in]  WMDM_FIND_SCOPE findScope,
  [in]  LPCWSTR         pwszUniqueID,
  [out] IWMDMStorage    **ppStorage
);

매개 변수

[in] findScope

검색할 scope 지정하는 WMDM_FIND_SCOPE 열거형입니다.

[in] pwszUniqueID

찾을 스토리지의 영구 고유 식별자입니다. 스토리지의 영구 고유 식별자는 스토리지의 g_wszWMDMPersistentUniqueID 메타데이터 속성에 의해 설명됩니다.

[out] ppStorage

검색된 스토리지에 대한 포인터입니다(있는 경우). 호출자는 이 인터페이스가 완료되면 이 인터페이스를 해제해야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. Windows Media 장치 관리자 모든 인터페이스 메서드는 다음 오류 코드 클래스 중 어느 것을 반환할 수 있습니다.

표준 COM 오류 코드
HRESULT 값으로 변환된 Windows 오류 코드
Windows Media 장치 관리자 오류 코드

가능한 오류 코드의 광범위한 목록은 오류 코드를 참조하세요.

설명

이 메서드는 디바이스에서 단일 메모리 개체(플래시 카드 또는 하드 디스크)만 검색합니다.

영구 고유 식별자는 특정 디바이스에 저장된 콘텐츠를 식별합니다. 모든 디바이스에서 동일하게 유지되는 콘텐츠별 전역 고유 식별자를 나타내지 않습니다. 따라서 다른 스토리지에 저장된 동일한 콘텐츠에는 다른 영구 고유 식별자가 있습니다. 마찬가지로 다른 디바이스에 저장할 때 다른 콘텐츠에 동일한 영구 고유 식별자가 있을 수 있습니다.

영구 고유 식별자의 형식은 디바이스에 따라 달라집니다. 애플리케이션은 이전에 스토리지를 가져오고 WMDM/PersistentUniqueID 속성에 대해 쿼리하여 영구 고유 식별자를 얻었어야 합니다. GetSpecifiedMetadata 또는 GetMetadata 메서드를 사용하여 이 속성을 요청합니다.