IPortableDeviceContent：：CreateObjectWithPropertiesOnly 方法 (portabledeviceapi.h)

CreateObjectWithPropertiesOnly 方法创建设备上仅具有属性的对象。

语法

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

pValues

要分配给对象的属性的 IPortableDeviceValues 集合。有关对象的必需属性和可选属性的列表，请参阅对象的要求。

[in, out] ppszObjectID

用于接收新对象名称的可选字符串指针。如果不需要，可以为 NULL。 Windows 便携设备定义常量WPD_DEVICE_OBJECT_ID来表示设备。 SDK 分配此内存;调用方必须使用 CoTaskMemFree 释放它。

该方法返回 HRESULT。可能的值包括（但并不限于）下表中的项。

返回代码	说明
S_OK	方法成功。
E_POINTER	至少一个必需的参数是 NULL 指针。

某些对象只是属性的集合（如文件夹，它只是指向其他对象的指针的集合），而其他对象既是属性又是数据，例如音频文件，其中包含所有属性和实际音乐位。此方法用于创建仅包含属性的对象。若要创建同时具有属性和数据的对象，请使用 CreateObjectWithPropertiesAndData。

此方法是同步的;当它返回时，新对象应存在于设备上。

驱动程序实际创建的对象可能是属性和数据对象，具体取决于哪种类型的对象对驱动程序最方便。若要检查驱动程序已创建的对象类型，请请求新对象的 WPD_OBJECT_FORMAT 属性。

此方法返回时，将在设备上创建对象。

有关如何使用此方法的示例，请参阅将 Properties-Only 对象传输到设备。