IPortableDeviceProperties::GetValues 메서드(portabledeviceapi.h)

아티클
03/01/2024

GetValues 메서드는 디바이스의 지정된 개체에서 지정된 속성 목록을 검색합니다.

구문

HRESULT GetValues(
  [in]  LPCWSTR                      pszObjectID,
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

매개 변수

[in] pszObjectID

쿼리할 개체의 ID를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 디바이스를 지정하려면 WPD_DEVICE_OBJECT_ID 사용합니다.

[in] pKeys

쿼리할 속성이 하나 이상 포함된 IPortableDeviceKeyCollection 인터페이스에 대한 포인터입니다. NULL이면 모든 속성이 검색됩니다. Windows 이식 가능한 디바이스에서 정의한 속성 목록은 속성 및 특성을 참조하세요.

[out] ppValues

요청된 속성 값이 포함된 IPortableDeviceValues 인터페이스에 대한 포인터를 수신하는 변수의 주소입니다. 값의 데이터 형식이 속성에 따라 달라지는 PROPERTYKEY/값 쌍으로 반환됩니다. 어떤 이유로 값을 검색할 수 없는 경우 반환된 형식이 VT_ERROR 검색 오류를 설명하는 HRESULT 값이 포함됩니다. 호출자는 이 인터페이스가 완료되면 이 인터페이스를 해제해야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	요청된 모든 속성 값이 검색되었습니다.
S_FALSE	하나 이상의 속성 값을 검색할 수 없습니다. 문제 속성은 검색된 ppValues 매개 변수에 HRESULT 값을 갖습니다.