IPortableDeviceCapabilities：：GetCommandOptions 方法 (portabledeviceapi.h)

  • 项目

GetCommandOptions 方法检索设备上指定命令的所有支持选项。

语法

HRESULT GetCommandOptions(
  [in]  REFPROPERTYKEY        Command,
  [out] IPortableDeviceValues **ppOptions
);

参数

[in] Command

一个 REFPROPERTYKEY，指定用于查询受支持选项的命令。 有关 Windows 可移植设备定义的命令列表，请参阅 命令。

[out] ppOptions

变量的地址，该变量接收指向包含支持选项的 IPortableDeviceValues 接口的指针。 如果不支持任何选项，则不包含任何值。 调用方在使用完此接口后必须释放此接口。 有关详细信息，请参阅“备注”。

返回值

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

返回代码 说明
S_OK
 方法成功。

注解

此方法由希望通过调用 IPortableDevice：：SendCommand 直接在驱动程序上调用命令的应用程序调用。 某些命令允许调用方指定其他选项。 例如，使用 WPD_COMMAND_OBJECT_MANAGEMENT_DELETE_OBJECTS 命令删除对象时，某些驱动程序支持递归子删除。

如果选项是简单的布尔值，则检索到的 IPortableDeviceValues 接口的键将是选项的名称， PROPVARIANT 值将是 true 或 False VT_BOOL值。 如果选项具有多个值，则检索到的 PROPVARIANT 值将是保存受支持值的集合类型。

如果为 WPD_COMMAND_STORAGE_FORMAT 命令调用此方法，并且 ppOptions 参数设置为 WPD_OPTION_VALID_OBJECT_IDS，则驱动程序将返回 VT_LPWSTR 类型的 IPortableDevicePropVariant 集合，该集合指定设备上可设置格式的每个对象的标识符。 (如果此选项不存在，则 format 命令适用于所有 objects.)

要求

要求 值
目标平台 Windows
标头 portabledeviceapi.h
Library PortableDeviceGUIDs.lib

另请参阅

IPortableDeviceCapabilities 接口