IMDSPStorage2::GetStorage 메서드(mswmdm.h)
GetStorage 메서드를 사용하면 모든 스토리지를 열거하는 대신 스토리지 이름에서 스토리지 개체로 직접 이동하여 찾을 수 있습니다.
구문
HRESULT GetStorage(
[in] LPCWSTR pszStorageName,
[out] IMDSPStorage **ppStorage
);
매개 변수
[in] pszStorageName
스토리지 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.
[out] ppStorage
pszStorageName으로 지정된 스토리지 개체에 대한 포인터이거나, 이러한 스토리지를 찾을 수 없는 경우 NULL입니다.
반환 값
이 메서드는 HRESULT를 반환합니다. Windows Media 장치 관리자 모든 인터페이스 메서드는 다음 오류 코드 클래스 중 어느 것을 반환할 수 있습니다.
- 표준 COM 오류 코드
- HRESULT 값으로 변환된 Windows 오류 코드
- Windows Media 장치 관리자 오류 코드
설명
IMDSPStorage2::GetStorage 인터페이스는 IMDSPStorage의 기능을 확장합니다.
IMDSPStorage2::GetStorage 는 와일드카드 문자를 지원하지 않습니다. 재귀적이지 않습니다. 즉, 현재 스토리지에서만 스토리지 개체를 찾을 수 있습니다.
이 메서드가 구현되지 않은 경우 E_NOTIMPL 반환해야 합니다. (이 메서드가 구현되지 않았음을 나타내는 WMDM_E_NOT_SUPPORTED 또는 다른 코드를 반환해서는 안 됩니다.) 이렇게 하면 Windows Media 장치 관리자 pszStorageName으로 전달된 스토리지 이름을 기반으로 일치하는 항목을 찾기 위해 모든 스토리지를 열거하여 이 기능 자체를 대체하려고 시도합니다.
이름에 따라 스토리지 개체를 효율적으로 반환하려면 서비스 공급자가 이 메서드를 구현하는 것이 좋습니다.
이 메서드는 선택 사항입니다. 자세한 내용은 필수 및 선택적 인터페이스를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | mswmdm.h |
| 라이브러리 | Mssachlp.lib |