Metodo IPortableDeviceCapabilities::GetCommandOptions (portabledeviceapi.h)

Il metodo GetCommandOptions recupera tutte le opzioni supportate per il comando specificato nel dispositivo.

Sintassi

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

Parametri

[in] Command

REFPROPERTYKEY che specifica un comando per eseguire una query per le opzioni supportate. Per un elenco dei comandi definiti dai dispositivi portatili Windows, vedere Comandi.

[out] ppOptions

Indirizzo di una variabile che riceve un puntatore a un'interfaccia IPortableDeviceValues che contiene le opzioni supportate. Se non sono supportate opzioni, questo non conterrà valori. Il chiamante deve rilasciare questa interfaccia al termine dell'operazione. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.

Commenti

Questo metodo viene chiamato dalle applicazioni che vogliono chiamare un comando direttamente sul driver chiamando IPortableDevice::SendCommand. Alcuni comandi consentono al chiamante di specificare opzioni aggiuntive. Ad esempio, alcuni driver supportano l'eliminazione ricorsiva figlio quando si elimina un oggetto usando il comando WPD_COMMAND_OBJECT_MANAGEMENT_DELETE_OBJECTS.

Se un'opzione è un valore booleano semplice, la chiave dell'interfaccia IPortableDeviceValues recuperata sarà il nome dell'opzione e il valore PROPVARIANT sarà un valore VT_BOOL True o False. Se un'opzione include diversi valori, il valore PROPVARIANT recuperato sarà un tipo di raccolta che contiene i valori supportati.

Se questo metodo viene chiamato per il comando WPD_COMMAND_STORAGE_FORMAT e il parametro ppOptions è impostato su WPD_OPTION_VALID_OBJECT_IDS, il driver restituirà un insieme IPortableDevicePropVariant di tipo VT_LPWSTR che specifica gli identificatori per ogni oggetto nel dispositivo che può essere formattato. Se questa opzione non esiste, il comando format è disponibile per tutti gli oggetti.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	portabledeviceapi.h
Libreria	PortableDeviceGUIDs.lib

Vedi anche

Interfaccia IPortableDeviceCapabilities