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

아티클
03/06/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 속성을 쿼리 하여 검색할 수 있는 스토리지의 영구 고유 식별자를 나타내는 null로 끝나는 와이드 문자열입니다.

[out] ppStorage

반환된 스토리지에 대한 포인터입니다. 호출자는 이 인터페이스가 완료되면 이 인터페이스를 해제해야 합니다.

반환 값

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

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

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

설명

영구 고유 식별자는 특정 디바이스에 저장된 콘텐츠를 고유하게 식별하는 데 사용됩니다. 모든 디바이스에서 동일하게 유지되는 콘텐츠별 전역 고유 식별자를 나타내지 않습니다. 따라서 다른 스토리지에 저장된 동일한 콘텐츠에는 다른 영구 고유 식별자가 있습니다. 마찬가지로, 다른 콘텐츠는 서로 다른 디바이스에 저장되는 경우 동일한 영구 고유 식별자를 가질 수 있습니다. 이 속성은 데이터베이스의 행과 유사한 디바이스의 콘텐츠 비유를 사용하여 ID 열이 데이터베이스에서 제공하는 것과 동일한 용도로 사용됩니다.

디바이스에서 생성되므로 영구 고유 식별자의 형식은 디바이스에 종속됩니다. 애플리케이션은 스토리지의 g_wszWMDMPersistentUniqueID 속성을 쿼리하여 영구 고유 식별자를 가져와야 합니다. 애플리케이션은 GetSpecifiedMetadata 또는 GetMetadata 메서드를 사용하여 이 속성을 쿼리할 수 있습니다.