Metodo IPortableDeviceProperties::GetPropertyAttributes (portabledeviceapi.h)

Articolo
08/25/2023

Il metodo GetPropertyAttributes recupera gli attributi di una proprietà oggetto specificata in un dispositivo.

Sintassi

HRESULT GetPropertyAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppAttributes
);

Parametri

[in] pszObjectID

Puntatore a una stringa con terminazione null contenente l'ID oggetto dell'oggetto da eseguire per eseguire query. Per specificare il dispositivo, usare WPD_DEVICE_OBJECT_ID.

[in] Key

REFPROPERTYKEY che specifica la proprietà da eseguire per la query. È possibile recuperare un elenco di proprietà supportate chiamando GetSupportedProperties. Per un elenco di proprietà definite dai dispositivi portatili windows, vedere Proprietà e attributi.

[out] ppAttributes

Indirizzo di una variabile che riceve un puntatore a un'interfaccia IPortableDeviceValues che contiene gli attributi delle proprietà recuperati. Queste sono coppie PROPERTYKEY/value, in cui PROPERTYKEY è la proprietà e il tipo di dati value dipende dalla proprietà specifica. Il chiamante deve rilasciare questa interfaccia al termine dell'operazione. Gli attributi definiti dai dispositivi portatili Windows sono disponibili nella pagina Proprietà e attributi .

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo e tutti gli attributi sono stati recuperati correttamente.
S_FALSE	È possibile recuperare solo alcuni valori di attributo. Altri non possono e conterrà un valore HRESULT di tipo VT_ERROR.
E_POINTER	Un argomento del puntatore obbligatorio è NULL.

Commenti

Gli attributi delle proprietà descrivono i diritti di accesso di una proprietà, i valori validi e altre informazioni. Ad esempio, una proprietà può avere un valore WPD_PROPERTY_ATTRIBUTE_CAN_DELETE impostato su False per impedire l'eliminazione e avere un intervallo di valori validi archiviati come singole voci.