Método IWDFNamedPropertyStore::GetNamedValue (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]
O método GetNamedValue recupera o valor de uma propriedade.
Sintaxe
HRESULT GetNamedValue(
[in] LPCWSTR pszName,
[out] PROPVARIANT *pv
);
Parâmetros
[in] pszName
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome da propriedade.
[out] pv
Um ponteiro para uma variável que recebe o valor da propriedade.
Retornar valor
GetNamedValue retornará S_OK se a operação for bem-sucedida. Caso contrário, esse método retornará um dos códigos de erro definidos em Winerror.h.
Comentários
O método GetNamedValue aloca memória para uma cadeia de caracteres na estrutura PROPVARIANT apontada pelo parâmetro pv . O chamador deve liberar essa memória chamando a função PropVariantClear , conforme mostrado no snippet a seguir:
hr = pPropStore->GetNamedValue(L"Host", &val);
...
PropVariantClear(&val);Se o chamador não liberar a memória, um vazamento de memória poderá resultar.
Os tipos de variante a seguir têm suporte para valores de propriedade. A tabela a seguir mostra o tipo variante retornado independentemente do tipo de variante original.
| Tipo de variante | Tipo de variante recuperado |
|---|---|
| VT_BSTR | Enquanto os clientes leem um valor de cadeia de caracteres, o valor é retornado como VT_LPWSTR independentemente do tipo de variante original que foi usado para gravar o valor. |
| VT_LPWSTR | |
| VT_LPSTR | |
| VT_I1 | Enquanto os clientes leem um valor inteiro, o valor é retornado como VT_UI4 independentemente do tipo de variante original que foi usado para gravar o valor. |
| VT_UI1 | |
| VT_I2 | |
| VT_UI2 | |
| VT_I4 | |
| VT_UI4 | |
| VT_UINT | |
| VT_BLOB | O valor binário é retornado como VT_BLOB. |
| VT_VECTOR | VT_LPWSTR | A matriz de cadeia de caracteres é retornada como VT_VECTOR | VT_LPWSTR |
Uma cadeia de caracteres que contém variáveis de ambiente é expandida na leitura.
Para obter mais informações, consulte Usando o Registro em drivers baseados em UMDF.
Requisitos
| Requisito | Valor |
|---|---|
| Fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| Plataforma de Destino | Área de Trabalho |
| Versão mínima do UMDF | 1.5 |
| Cabeçalho | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |