Metodo IWDFNamedPropertyStore::SetNamedValue (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. Non vengono aggiunte nuove funzionalità 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 info, vedi Introduzione con UMDF.]
Il metodo SetNamedValue imposta il valore di una proprietà.
Sintassi
HRESULT SetNamedValue(
[in] LPCWSTR pszName,
[in] const PROPVARIANT *pv
);
Parametri
[in] pszName
Puntatore a una stringa con terminazione Null contenente il nome della proprietà.
[in] pv
Puntatore al valore su cui è impostata la proprietà.
Valore restituito
SetNamedValue 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
Per i valori delle proprietà sono supportati i tipi varianti seguenti. Nella tabella seguente vengono illustrati i tipi di valori scritti dal framework per tipi varianti specifici.
| Tipo variant | Scrittura |
|---|---|
| VT_BSTR | Scrive un valore stringa. |
| VT_LPWSTR | |
| VT_LPSTR | |
| VT_I1 | Scrive un valore intero. |
| VT_UI1 | |
| VT_I2 | |
| VT_UI2 | |
| VT_I4 | |
| VT_UI4 | |
| VT_UINT | |
| VT_BLOB | Scrive un valore binario. |
| VT_VECTOR | VT_LPWSTR | Scrive una matrice di stringhe. |
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 |