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

FindStorage 메서드는 지정된 영구 고유 식별자가 있는 스토리지를 찾습니다. 스토리지의 영구 고유 식별자는 해당 스토리지의 g_wszWMDMPersistentUniqueID 속성에 의해 설명됩니다.

구문

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

[in] findScope

찾기 작업의 범위입니다. 다음 값 중 하나여야 합니다.

값	Description
WMDM_FIND_SCOPE_GLOBAL	전체 디바이스를 검색합니다.
WMDM_FIND_SCOPE_IMMEDIATE_CHILDREN	현재 스토리지의 직위 자식에서만 검색합니다.

[in] pwszUniqueID

스토리지의 영구 고유 식별자입니다.

[out] ppStorage

pwszUniqueID 매개 변수로 지정된 반환된 스토리지에 대한 포인터입니다.

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

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

서비스 공급자는 스토리지의 g_wszWMDMPersistentUniqueID 속성을 통해 영구 고유 식별자를 반환합니다. 특정 스토리지의 경우 서비스 공급자가 제공하는 영구 고유 식별자는 서로 다른 디바이스 연결 세션에서 동일해야 합니다.

애플리케이션은 나중에 이 영구 고유 식별자를 사용하여 FindStorage 를 호출할 수 있습니다. 이에 대한 응답으로 Windows Media 장치 관리자 서비스 공급자에서 이 메서드를 호출합니다.

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

이 메서드를 사용하면 영구 고유 식별자를 기반으로 스토리지를 검색할 수 있지만 IMDSPStorage2::GetStorage 를 사용하면 이름에 따라 스토리지를 검색할 수 있습니다.

Windows Media 장치 관리자 Windows 미디어 플레이어 동기화할 수 있는 디바이스에 대해서만 이 메서드를 호출합니다. 자세한 내용은 Windows 미디어 플레이어 동기화 사용을 참조하세요.