Метод 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 будет VT_BOOL значение True или False. Если параметр имеет несколько значений, полученное значение PROPVARIANT будет типом коллекции, который содержит поддерживаемые значения.

Если этот метод вызывается для команды WPD_COMMAND_STORAGE_FORMAT и параметру ppOptions задано значение WPD_OPTION_VALID_OBJECT_IDS, драйвер возвращает коллекцию IPortableDevicePropVariant типа VT_LPWSTR, которая задает идентификаторы для каждого объекта на устройстве, который можно отформатировать. (Если этот параметр не существует, команда format доступна для всех объектов.)

Требования

Требование	Значение
Целевая платформа	Windows
Header	portabledeviceapi.h
Библиотека	PortableDeviceGUIDs.lib

См. также раздел

Интерфейс IPortableDeviceCapabilities