Função wiauRegGetStrW (wiautil.h)

Artigo
02/07/2025

A função wiauRegGetStr obtém um valor de cadeia de caracteres da seção DeviceData do Registro.

Sintaxe

HRESULT wiauRegGetStrW(
  [in]      HKEY   hkKey,
  [in]      PCWSTR pwszValueName,
  [out]     PWSTR  pwszValue,
  [in, out] WORD   *pdwLength
);

Parâmetros

[in] hkKey

Especifica o identificador de chave do Registro. Esse parâmetro deve ser definido como o valor apontado pelo parâmetro phkeyDeviceData quando wiauRegOpenData retorna.

[in] pwszValueName

Aponta para o primeiro caractere de uma cadeia de caracteres Unicode que contém o nome da entrada do Registro.

[out] pwszValue

Ponteiro para um local de memória que recebe o valor da cadeia de caracteres, incluindo um caractere nulo de encerramento.

[in, out] pdwLength

Ponteiro para um local de memória que recebe o comprimento, em bytes, do valor da cadeia de caracteres apontado pelo parâmetro pwszValue. O comprimento inclui o caractere nulo de encerramento.

Valor de retorno

Com êxito, a função retorna S_OK. Se a função falhar, ela retornará um erro COM padrão.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	wiautil.h (inclua Wiautil.h)

Consulte também

wiauRegGetDword

wiauRegOpenData

Compartilhar via