IPortableDeviceCapabilities::GetFunctionalObjects 메서드(portabledeviceapi.h)

GetFunctionalObjects 메서드는 디바이스에서 지정된 범주와 일치하는 모든 기능 개체를 검색합니다.

구문

HRESULT GetFunctionalObjects(
  [in]  REFGUID                              Category,
  [out] IPortableDevicePropVariantCollection **ppObjectIDs
);

매개 변수

[in] Category

검색할 범주를 지정하는 REFGUID 입니다. 이 WPD_FUNCTIONAL_CATEGORY_ALL 모든 기능 개체를 반환할 수 있습니다.

[out] ppObjectIDs

함수 개체의 개체 ID를 문자열로 포함하는 IPortableDevicePropVariantCollection 인터페이스에 대한 포인터를 수신하는 변수의 주소입니다(검색된 PROPVARIANT 항목에 VT_LPWSTR 입력). 요청된 형식의 개체를 찾을 수 없는 경우 빈 컬렉션( NULL 아님)이 됩니다. 호출자는 이 인터페이스가 완료되면 이 인터페이스를 해제해야 합니다.

반환 값

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

반환 코드	설명
S_OK	메서드가 성공했습니다.

설명

드라이버가 전체 콘텐츠 열거를 수행할 필요가 없으며 검색된 기능 개체 수가 일반적으로 10개 미만이므로 이 작업은 일반적으로 빠릅니다. 요청된 형식의 개체를 찾을 수 없는 경우 이 메서드는 오류를 반환하지 않고 ppObjectIDs에 대한 빈 컬렉션을 반환합니다.

예제

이 메서드를 사용하는 방법에 대한 예제는 디바이스에 대한 기능 개체 식별자 검색을 참조하세요.

요구 사항

대상 플랫폼	Windows
헤더	portabledeviceapi.h
라이브러리	PortableDeviceGUIDs.lib

추가 정보

IPortableDeviceCapabilities 인터페이스

디바이스에 대한 기능 개체 식별자 검색

디바이스에서 지원하는 렌더링 기능 검색