WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION 命令

WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION 命令检索可以保存指定类型的对象的文件夹的对象 ID。 与暴力对象枚举相比，客户端可以通过此命令更快地发现设备存储特定对象的位置。

命令类别

WPD_CATEGORY_DEVICE_HINTS

参数

驱动程序需要以下参数。

参数	VarType	说明
WPD_PROPERTY_DEVICE_HINTS_CONTENT_TYPE	VT_CLSID	必需。 调用方希望查找其容器的对象类型。 例如，若要查找用于在数码相机上保存图像的顶级文件夹，调用方将提交WPD_CONTENT_TYPE_IMAGE。 有关 Windows 可移植设备定义的对象类型列表，请参阅 对象要求 。

返回值

驱动程序应返回以下结果。

结果	VarType	说明
WPD_PROPERTY_DEVICE_HINTS_CONTENT_LOCATIONS	VT_UNKNOWN	必需。 类型的 IPortableDevicePropVariantCollection VT_LPWSTR值，用于指定包含调用参数所指示类型的对象的文件夹的对象 ID。 如果未找到任何文件夹，则此列表应为空列表。结果指示的文件夹可能包含也可能不包含其他内容类型的对象。 有关文件夹限制的信息，请参阅 WPD_FOLDER_CONTENT_TYPES_ALLOWED 属性。
WPD_PROPERTY_COMMON_HRESULT	VT_ERROR	必需。 指示处理命令成功或失败的 HRESULT 。 如果调用方发出无效请求，驱动程序应返回 HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED) ，不需要返回任何其他结果值。 错误代码包括 Windows 可移植设备错误代码 或任何其他适当的错误代码。
WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE	VT_UI4	可选。 特定于驱动程序的错误代码。 这通常仅用于驱动程序测试，或者驱动程序、设备和客户端都是一起设计的。

调用方法

只能使用 IPortableDevice：：SendCommand 直接调用。

要求

要求	值
标头	PortableDevice.h