Método IWDFNamedPropertyStore::GetNamedValue (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción a UMDF.]
El método GetNamedValue recupera el valor de una propiedad .
Sintaxis
HRESULT GetNamedValue(
[in] LPCWSTR pszName,
[out] PROPVARIANT *pv
);
Parámetros
[in] pszName
Puntero a una cadena terminada en null que contiene el nombre de la propiedad.
[out] pv
Puntero a una variable que recibe el valor de la propiedad .
Valor devuelto
GetNamedValue devuelve S_OK si la operación se realiza correctamente. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h.
Observaciones
El método GetNamedValue asigna memoria para una cadena en la estructura PROPVARIANT apuntada por el parámetro pv. A continuación, el autor de la llamada debe liberar esta memoria llamando a la función PropVariantClear, como se muestra en el siguiente fragmento de código:
hr = pPropStore->GetNamedValue(L"Host", &val);
...
PropVariantClear(&val);Si el autor de la llamada no libera la memoria, puede producirse una pérdida de memoria.
Se admiten los siguientes tipos de variantes para los valores de propiedad. En la tabla siguiente se muestra el tipo de variante que se devuelve independientemente del tipo de variante original.
| Tipo de variante | Tipo de variante recuperado |
|---|---|
| VT_BSTR | Mientras los clientes leen un valor de cadena, el valor se devuelve como VT_LPWSTR independientemente del tipo de variante original que se usó para escribir el valor. |
| VT_LPWSTR | |
| VT_LPSTR | |
| VT_I1 | Mientras los clientes leen un valor entero, el valor se devuelve como VT_UI4 independientemente del tipo de variante original que se usó para escribir el valor. |
| VT_UI1 | |
| VT_I2 | |
| VT_UI2 | |
| VT_I4 | |
| VT_UI4 | |
| VT_UINT | |
| VT_BLOB | El valor binario se devuelve como VT_BLOB. |
| VT_VECTOR | VT_LPWSTR | La matriz de cadenas se devuelve como VT_VECTOR | VT_LPWSTR |
Una cadena que contiene variables de entorno se expande en lectura.
Para obtener más información, vea Using the Registry in UMDF-based Drivers.
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.5 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |