Método IPortableDeviceCapabilities::GetCommandOptions (portabledeviceapi.h)

O método GetCommandOptions recupera todas as opções com suporte para o comando especificado no dispositivo.

Sintaxe

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

Parâmetros

[in] Command

Um REFPROPERTYKEY que especifica um comando para consultar as opções com suporte. Para obter uma lista dos comandos definidos por Dispositivos Portáteis do Windows, consulte Comandos.

[out] ppOptions

Endereço de uma variável que recebe um ponteiro para uma interface IPortableDeviceValues que contém as opções com suporte. Se não houver suporte para nenhuma opção, isso não conterá nenhum valor. O chamador deve liberar essa interface quando terminar de usá-la. Para obter mais informações, consulte Comentários.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Esse método é chamado por aplicativos que desejam chamar um comando diretamente no driver chamando IPortableDevice::SendCommand. Alguns comandos permitem que o chamador especifique opções adicionais. Por exemplo, alguns drivers dão suporte à exclusão filho recursiva ao excluir um objeto usando o comando WPD_COMMAND_OBJECT_MANAGEMENT_DELETE_OBJECTS.

Se uma opção for um valor booliano simples, a chave da interface IPortableDeviceValues recuperada será o nome da opção e o valor PROPVARIANT será um valor VT_BOOL de True ou False. Se uma opção tiver vários valores, o valor PROPVARIANT recuperado será um tipo de coleção que contém os valores com suporte.

Se esse método for chamado para o comando WPD_COMMAND_STORAGE_FORMAT e o parâmetro ppOptions estiver definido como WPD_OPTION_VALID_OBJECT_IDS, o driver retornará uma coleção IPortableDevicePropVariant do tipo VT_LPWSTR que especifica os identificadores de cada objeto no dispositivo que pode ser formatado. (Se essa opção não existir, o comando format estará disponível para todos os objetos.)

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceCapabilities Interface