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

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

구문

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

[in] findScope

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

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

[in] pwszUniqueID

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

[out] ppStorage

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

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

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

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

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

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

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