다음을 통해 공유

IMDSPDevice2::GetStorage 메서드(mswmdm.h)

  • 아티클

GetStorage 메서드를 사용하면 모든 스토리지를 열거하는 대신 이름을 기반으로 스토리지로 직접 이동하여 찾을 수 있습니다.

구문

HRESULT GetStorage(
  [in]  LPCWSTR      pszStorageName,
  [out] IMDSPStorage **ppStorage
);

매개 변수

[in] pszStorageName

찾을 스토리지의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[out] ppStorage

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

반환 값

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

  • 표준 COM 오류 코드
  • HRESULT 값으로 변환된 Windows 오류 코드
  • Windows Media 장치 관리자 오류 코드
가능한 오류 코드의 광범위한 목록은 오류 코드를 참조하세요.

설명

GetStorage 메서드는 와일드카드 문자를 지원하지 않습니다. 재귀적이지 않습니다. 즉, 디바이스의 루트에서만 스토리지를 찾을 수 있습니다.

이 메서드가 구현되지 않은 경우 E_NOTIMPL 반환해야 합니다. (이 메서드가 구현되지 않았음을 나타내는 WMDM_E_NOT_SUPPORTED 또는 다른 코드를 반환해서는 안 됩니다.) 이렇게 하면 Windows Media 장치 관리자 pszStorageName으로 전달된 스토리지 이름을 기반으로 일치하는 항목을 찾기 위해 모든 스토리지를 열거하여 이 기능 자체를 대체하려고 시도합니다.

이름에 따라 스토리지 개체를 효율적으로 반환하려면 서비스 공급자가 이 메서드를 구현하는 것이 좋습니다.

이 메서드는 선택 사항입니다. 자세한 내용은 필수 및 선택적 인터페이스를 참조하세요.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 mswmdm.h
라이브러리 Mssachlp.lib

추가 정보

IMDSPDevice2 인터페이스