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를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 반환 코드 | 설명 |
|---|---|
|
메서드가 성공했습니다. |
설명
드라이버가 전체 콘텐츠 열거를 수행할 필요가 없으며 검색된 기능 개체 수가 일반적으로 10개 미만이므로 이 작업은 일반적으로 빠릅니다. 요청된 형식의 개체를 찾을 수 없는 경우 이 메서드는 오류를 반환하지 않고 ppObjectIDs에 대한 빈 컬렉션을 반환합니다.
예제
이 메서드를 사용하는 방법에 대한 예제는 디바이스에 대한 기능 개체 식별자 검색을 참조하세요.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | portabledeviceapi.h |
| 라이브러리 | PortableDeviceGUIDs.lib |