Metodo IWDFNamedPropertyStore::GetNamedValue (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione con UMDF.]
Il metodo GetNamedValue recupera il valore di una proprietà.
Sintassi
HRESULT GetNamedValue(
[in] LPCWSTR pszName,
[out] PROPVARIANT *pv
);
Parametri
[in] pszName
Puntatore a una stringa con terminazione null contenente il nome della proprietà.
[out] pv
Puntatore a una variabile che riceve il valore per la proprietà.
Valore restituito
GetNamedValue restituisce S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo restituisce uno dei codici di errore definiti in Winerror.h.
Commenti
Il metodo GetNamedValue alloca la memoria per una stringa nella struttura PROPVARIANT a cui punta il parametro pv . Il chiamante deve quindi liberare questa memoria chiamando la funzione PropVariantClear , come illustrato nel frammento di codice seguente:
hr = pPropStore->GetNamedValue(L"Host", &val);
...
PropVariantClear(&val);Se il chiamante non libera la memoria, potrebbe verificarsi una perdita di memoria.
Per i valori delle proprietà sono supportati i tipi varianti seguenti. Nella tabella seguente viene illustrato il tipo variant restituito indipendentemente dal tipo variant originale.
| Tipo variant | Tipo variant recuperato |
|---|---|
| VT_BSTR | Mentre i client leggeno un valore stringa, il valore viene restituito come VT_LPWSTR indipendentemente dal tipo di variante originale usato per scrivere il valore. |
| VT_LPWSTR | |
| VT_LPSTR | |
| VT_I1 | Mentre i client leggeno un valore intero, il valore viene restituito come VT_UI4 indipendentemente dal tipo di variante originale usato per scrivere il valore. |
| VT_UI1 | |
| VT_I2 | |
| VT_UI2 | |
| VT_I4 | |
| VT_UI4 | |
| VT_UINT | |
| VT_BLOB | Il valore binario viene restituito come VT_BLOB. |
| VT_VECTOR | VT_LPWSTR | La matrice di stringhe viene restituita come VT_VECTOR | VT_LPWSTR |
Una stringa che contiene variabili di ambiente viene espansa in lettura.
Per altre informazioni, vedere Uso del Registro di sistema nei driver basati su UMDF.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1.5 |
| Intestazione | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |