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

GetSpecifiedMetadata 메서드는 스토리지에 대해 지정된 메타데이터 개체만 검색합니다.

구문

HRESULT GetSpecifiedMetadata(
  [in]  DWORD         cProperties,
  [in]  LPCWSTR       *ppwszPropNames,
  [out] IWMDMMetaData *pMetadata
);

[in] cProperties

검색할 속성의 수입니다.

[in] ppwszPropNames

검색할 속성 이름을 포함하는 배열입니다. 이 배열의 크기는 cProperties와 같아야 합니다.

[out] pMetadata

반환된 IWMDMMetaData 인터페이스 포인터에 대한 포인터입니다.

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

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

이 메서드는 검색되는 속성을 클라이언트에 제어합니다. 클라이언트는 클라이언트가 검색해야 하는 속성의 속성 이름을 지정할 수 있습니다.

반면 GetMetadata 메서드는 모든 스토리지 메타데이터(속성)를 검색합니다.

지정된 속성을 반환할 수 없는 경우 서비스 공급자는 WMDM_E_NOTSUPPORTED 또는 적합한 오류 코드를 반환해야 합니다.

하나 이상의 속성을 검색할 수 있는 경우 서비스 공급자는 해당 속성을 반환하고 반환 코드를 WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED 성공 코드로 설정해야 합니다.