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

아티클
02/29/2024

GetSpecifiedMetadata 메서드는 스토리지에서 하나 이상의 특정 메타데이터 속성을 검색합니다.

구문

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

매개 변수

[in] cProperties

검색할 속성의 수입니다.

[in] ppwszPropNames

검색할 속성 이름의 배열입니다. 이 배열의 길이는 cProperties와 같아야 합니다. 애플리케이션은 CoTaskMemFree를 사용하여 이 메모리를 해제해야 합니다.

[out] ppMetadata

검색된 값을 포함하는 반환된 IWMDMMetaData 인터페이스 포인터에 대한 포인터입니다. 호출자는 이 인터페이스가 완료되면 이 인터페이스를 해제해야 합니다.

반환 값

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

표준 COM 오류 코드
HRESULT 값으로 변환된 Windows 오류 코드
Windows Media 장치 관리자 오류 코드

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

설명

이 메서드는 검색되는 속성을 클라이언트에 제어합니다. 이는 IWMDMStorage3::GetMetadata보다 더 효율적일 수 있으며, 클라이언트에 스토리지에서 지원하는 속성의 하위 집합만 필요한 경우에 권장됩니다.

이 메서드를 사용하여 WPD(Windows Portable Devices) 디바이스에서 데이터를 검색하는 경우 데이터는 IPortableDeviceValues 개체에서 이진 형식으로 반환됩니다. 애플리케이션은 실제 속성 값을 얻기 위해 이 데이터를 직렬화 해제해야 합니다.

지정된 속성 중 일부를 검색할 수 없는 경우에도 메서드가 성공하고 WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED 반환합니다(그러나 하나 이상의 속성이 검색됨). 지정된 속성을 검색할 수 없는 경우 메서드가 실패하고 WMDM_E_NOTSUPPORTED 반환합니다.

단일 속성을 요청하는 것은 이 메서드의 특별한 경우입니다. 클라이언트가 단일 속성을 요청하는 경우 가능한 반환 코드는 S_OK, E_INVALIDARG 및 WMDM_E_NOTSUPPORTED. 따라서 단일 속성의 경우 속성이 성공적으로 검색된 경우에만 메서드가 성공합니다.