IPortableDeviceContent：：CreateObjectWithPropertiesOnly 方法 (portabledeviceapi.h)

CreateObjectWithPropertiesOnly 方法會建立只有裝置屬性的物件。

語法

HRESULT CreateObjectWithPropertiesOnly(
            IPortableDeviceValues *pValues,
  [in, out] LPWSTR                *ppszObjectID
);

pValues

要指派給對象的屬性 IPortableDeviceValues 集合。如需物件的必要和選擇性屬性清單，請參閱 Objects 的需求。

[in, out] ppszObjectID

要接收新物件名稱的選擇性字串指標。如果不需要 ，可以是 NULL。 Windows 可攜式裝置會定義代表裝置的常數WPD_DEVICE_OBJECT_ID。 SDK 會配置此記憶體;呼叫端必須使用 CoTaskMemFree 釋放它。

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

傳回碼	描述
S_OK	此方法已成功。
E_POINTER	至少有一個必要的自變數是 NULL 指標。

某些物件只是屬性的集合，例如資料夾，只是其他物件的指標集合，而其他物件則是屬性和數據，例如包含所有屬性和實際音樂位的音訊檔案。這個方法可用來建立只包含屬性的物件。若要建立同時具有屬性和數據的物件，請使用 CreateObjectWithPropertiesAndData。

這個方法是同步的;當它傳回時，新的對象應該會出現在裝置上。

驅動程式實際建立的物件可能是屬性和數據對象，視驅動程式最方便的物件類型而定。若要檢查驅動程式建立的物件類型，請要求新物件的 WPD_OBJECT_FORMAT 屬性。

此方法傳回時，將會在裝置上建立物件。

如需如何使用此方法的範例，請參閱將 Properties-Only 對象傳送至裝置。