Metodo IPortableDeviceContent::D elete (portabledeviceapi.h)

Articolo
03/13/2024

Il metodo Delete elimina uno o più oggetti dal dispositivo.

Sintassi

HRESULT Delete(
  [in]      const DWORD                          dwOptions,
  [in]      IPortableDevicePropVariantCollection *pObjectIDs,
  [in, out] IPortableDevicePropVariantCollection **ppResults
);

Parametri

[in] dwOptions

Uno degli enumeratori DELETE_OBJECT_OPTIONS .

[in] pObjectIDs

Puntatore a un'interfaccia IPortableDevicePropVariantCollection che contiene una o più stringhe con terminazione Null (tipo VT_LPWSTR) che specifica gli ID oggetto degli oggetti da eliminare.

[in, out] ppResults

facoltativo. In caso contrario, questo parametro contiene una raccolta di VT_ERROR valori che indicano l'esito positivo o negativo dell'operazione. Il primo elemento restituito in ppResults corrisponde al primo oggetto dell'insieme pObjectIDs , il secondo elemento restituito in ppResults corrisponde al secondo oggetto dell'insieme pObjectIDs e così via. Questo parametro può essere NULL se l'applicazione non riguarda i risultati.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Se viene restituito un valore di errore, nel dispositivo non sono stati eliminati oggetti.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
S_FALSE	Non è stato possibile eliminare almeno un oggetto. Il parametro ppResults , se specificato, contiene il codice di errore per oggetto.
E_XXXXXXXX	Il driver non ha eliminato alcun oggetto.
E_INVALIDARG	È stato specificato un valore non valido per dwOptions.
E_ACCESSDENIED	L'applicazione non dispone dell'autorizzazione per eliminare l'oggetto.
HRESULT_FROM_WIN32(ERROR_DIR_NOT_EMPTY)	Impossibile eliminare la cartella o la directory specificata perché non era vuota.
HRESULT_FROM_WIN32(ERROR_INVALID_OPERATION)	L'applicazione specificata PORTABLE_DEVICE_DELETE_NO_RECURSION e l'oggetto include elementi figlio.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Impossibile eliminare l'oggetto perché non esiste nel dispositivo.

Commenti

Per verificare se l'eliminazione ricorsiva è supportata, chiamare IPortableDeviceCapabilities::GetCommandOptions. Se l'interfaccia IPortableDeviceValues recuperata contiene un valore di proprietà denominato WPD_OPTION_OBJECT_MANAGEMENT_RECURSIVE_DELETE_SUPPORTED con un valore boolVal true, il dispositivo supporta l'eliminazione ricorsiva.

Nella tabella seguente sono elencati i possibili codici restituiti che possono essere visualizzati nell'insieme in corrispondenza dei quali ppResults punta.

Esempio

Per un esempio di come usare questo metodo, vedere Eliminazione di contenuto dal dispositivo.

Requisiti

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

Vedi anche

Eliminazione del contenuto dal dispositivo

Interfaccia IPortableDeviceContent

Condividi tramite