IPortableDeviceCapabilities：：GetSupportedFormatProperties 方法 (portabledeviceapi.h)

GetSupportedFormatProperties方法會擷取裝置上指定格式的物件所支援的屬性。

語法

HRESULT GetSupportedFormatProperties(
  [in]  REFGUID                      Format,
  [out] IPortableDeviceKeyCollection **ppKeys
);

[in] Format

指定物件格式的 REFGUID 。如需 Windows 可攜式裝置所定義的格式清單，請參閱物件格式。

[out] ppKeys

接收 IPortableDeviceKeyCollection 介面指標的變數位址，其中包含所指定格式支援的屬性。如需 Windows 可攜式裝置所定義的屬性清單，請參閱屬性和屬性。呼叫端必須在完成此介面時釋放此介面。

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

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

您可以指定Format參數的WPD_OBJECT_FORMAT_ALL，以擷取完整的屬性屬性集。

如果物件沒有指派給特定屬性的值，或者如果已刪除屬性，則裝置在列舉其屬性時可能完全不會報告屬性。另一個裝置可能會報告屬性，但具有空字串或零的值。若要避免這種不一致，您可以呼叫此方法來瞭解您可以在特定物件上設定的所有屬性。