Método IWDFNamedPropertyStore::GetNamedValue (wudfddi.h)

Artigo
02/07/2025

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução aoda 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.

Valor de retorno

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.

Observações

O método GetNamedValue aloca memória para uma cadeia de caracteres na estrutura PROPVARIANT apontada pelo parâmetro pv. Em seguida, 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 de 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.
da Plataforma de Destino	Área de trabalho
versão mínima do UMDF	1.5
cabeçalho	wudfddi.h (inclua Wudfddi.h)
de DLL	WUDFx.dll

Consulte também

IWDFNamedPropertyStore

PROPVARIANT

propVariantClear

Compartilhar via