Metodo IMDSPDevice3::GetProperty (mswmdm.h)

Articolo
02/29/2024

Il metodo GetProperty recupera una proprietà del dispositivo specifica.

Sintassi

HRESULT GetProperty(
  [in]  LPCWSTR     pwszPropName,
  [out] PROPVARIANT *pValue
);

Parametri

[in] pwszPropName

Nome della proprietà recuperata dal dispositivo.

[out] pValue

Valore restituito per la proprietà .

Valore restituito

Il metodo restituisce un valore HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

La variante a cui pValue punta è impostata su un PROPVARIANT vuoto, ovvero il relativo VT è impostato su VT_EMPTY.

Il provider di servizi deve impostare questa variante sul valore della proprietà appropriato per la proprietà pwszPropName.

Se pwszPropName è g_wszWMDMSupportedDeviceProperties, il provider di servizi deve restituire una matrice delle proprietà del dispositivo supportate. In tal caso, la vt della variante deve essere VT_BSTR | VT_ARRAY.

Per un elenco dei nomi delle proprietà dei dispositivi standard, vedere Costanti dei metadati.

Questo metodo è simile ai metodi IMDSPStorage3::GetMetadata e IMDSPStorage4::GetSpecifiedMetadata per le risorse di archiviazione, ma questo metodo può ottenere una sola proprietà alla volta.