共用方式為

IPortableDeviceCapabilities：：GetFunctionalObjects 方法 (portabledeviceapi.h)

  • 發行項

GetFunctionalObjects方法會擷取符合裝置上指定類別的所有功能物件。

語法

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

參數

[in] Category

REFGUID，指定要搜尋的類別。 這可以WPD_FUNCTIONAL_CATEGORY_ALL傳回所有功能物件。

[out] ppObjectIDs

接收 IPortableDevicePropVariantCollection 介面指標的變數位址，該介面包含函式物件的物件識別碼，做為所擷取 之 PROPVARIANT 專案中VT_LPWSTR字串 (類型) VT_LPWSTR。 如果找不到要求類型的物件，則這會是空集合， (不是 Null) 。 呼叫端必須在使用此介面完成時釋放這個介面。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 此方法已成功。

備註

這項作業通常很快，因為驅動程式不需要執行完整內容列舉，而且擷取的功能物件數目通常小於 10。 如果找不到要求類型的物件，這個方法將不會傳回錯誤，但會傳回 ppObjectID 的空集合。

範例

如需如何使用此方法的範例，請參閱 擷取裝置的功能物件識別碼

需求

   
目標平台 Windows
標頭 portabledeviceapi.h
程式庫 PortableDeviceGUIDs.lib

另請參閱

IPortableDeviceCapabilities 介面

擷取裝置的功能物件識別碼

擷取裝置支援的轉譯功能