Función SHQueryValueExW (shlwapi.h)

Abre una clave del Registro y la consulta para un valor específico.

Sintaxis

LSTATUS SHQueryValueExW(
  [in]                HKEY    hkey,
  [in, optional]      LPCWSTR pszValue,
                      DWORD   *pdwReserved,
  [out, optional]     DWORD   *pdwType,
  [out, optional]     void    *pvData,
  [in, out, optional] DWORD   *pcbData
);

Parámetros

[in] hkey

Tipo: HKEY

Identificador de la clave actualmente abierta o cualquiera de los siguientes valores predefinidos.

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[in, optional] pszValue

Tipo: LPCTSTR

Dirección de la cadena terminada en null que contiene el nombre del valor que se va a consultar.

pdwReserved

Tipo: LPDWORD

Reservado. Debe ser NULL.

[out, optional] pdwType

Tipo: LPDWORD

Dirección de la variable que recibe el tipo de valor de la clave. Para obtener más información, vea Tipos de datos del Registro.

[out, optional] pvData

Tipo: LPVOID

Dirección del búfer que recibe los datos del valor. Este parámetro puede ser NULL si los datos no son necesarios.

[in, out, optional] pcbData

Tipo: LPDWORD

Dirección de la variable que especifica el tamaño, en bytes, del búfer al que apunta el parámetro pvData . Cuando se devuelve la función, esta variable contiene el tamaño de los datos copiados en pvData.

Valor devuelto

Tipo: DWORD

Devuelve ERROR_SUCCESS si se ejecuta correctamente o un código de error distinto de cero definido en Winerror.h en caso contrario. Puede usar la función FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para recuperar una descripción genérica del error.

Comentarios

Requisitos