Metodo IPortableDeviceProperties::D elete (portabledeviceapi.h)

Articolo
08/25/2023

Il metodo Delete elimina le proprietà specificate da un oggetto specificato in un dispositivo.

Sintassi

HRESULT Delete(
  [in] LPCWSTR                      pszObjectID,
  [in] IPortableDeviceKeyCollection *pKeys
);

Parametri

[in] pszObjectID

Puntatore a una stringa con terminazione Null che specifica l'ID dell'oggetto le cui proprietà verranno eliminate. Per specificare il dispositivo, usare WPD_DEVICE_OBJECT_ID.

[in] pKeys

Puntatore a un'interfaccia IPortableDeviceKeyCollection che specifica le proprietà da eliminare. Per un elenco delle proprietà definite dai dispositivi portatili Windows, vedere Proprietà e attributi.

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.
S_FALSE	Impossibile eliminare uno o più valori di proprietà.
E_POINTER	L'argomento del puntatore richiesto è NULL.

Commenti

Le proprietà possono essere eliminate solo se il relativo attributo WPD_PROPERTY_ATTRIBUTE_CAN_DELETE è True. Questo attributo può essere recuperato chiamando GetPropertyAttributes.

Il driver non ha modo di indicare l'esito positivo parziale; ovvero, se solo alcune proprietà potrebbero essere eliminate, il driver restituirà S_FALSE, ma questo metodo non indica quali proprietà sono state eliminate correttamente. L'unico modo per imparare quali proprietà sono state eliminate consiste nel richiedere tutte le proprietà chiamando IPortableDeviceProperties::GetValues.

Requisiti

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

Vedi anche

Interfaccia IPortableDeviceProperties

Condividi tramite