Función SHRegGetValueFromHKCUHKLM (shlwapi.h)

[Esta función ya no se admite.]

Obtiene información especificada del Registro. Esta función comprobará HKEY_CURRENT_USER la información solicitada en la subclave especificada. Si la información no existe en el subárbol HKEY_CURRENT_USER, la función comprueba el subárbol HKEY_LOCAL_MACHINE para obtener la misma información.

Sintaxis

LSTATUS SHRegGetValueFromHKCUHKLM(
  [in]      PCWSTR pwszKey,
  [in]      PCWSTR pwszValue,
  [in]      SRRF   srrfFlags,
  [out]     DWORD  *pdwType,
  [in]      void   *pvData,
  [in, out] DWORD  *pcbData
);

Parámetros

[in] pwszKey

Tipo: PCWSTR

Puntero a una cadena Unicode terminada en null que especifica la ruta de acceso a la clave del Registro.

[in] pwszValue

Tipo: PCWSTR

Puntero a una cadena Unicode terminada en null que especifica el valor de clave. Este valor puede ser NULL, en cuyo caso los datos se recuperan del valor predeterminado.

[in] srrfFlags

Tipo: SRRF

Constantes de marca SRRF . Si se usa más de una marca, se pueden combinar con un OR bit a bit. Estas marcas se usan para restringir el tipo de datos devueltos. Este valor no puede ser 0.

[out] pdwType

Tipo: DWORD*

Cuando esta función devuelve, contiene un puntero a un DWORD que recibe un código que indica el tipo de datos almacenados en el valor especificado. Esto se puede establecer en NULL si no se desea información de tipo. Si este valor no es NULL y no se ha establecido la marca SRRF_NOEXPAND, los tipos de datos de REG_EXPAND_SZ se devolverán como REG_SZ ya que se expanden automáticamente en este método.

[in] pvData

Tipo: LPCVOID

Puntero a un búfer que contiene los datos del valor. Este parámetro puede ser NULL si los datos no son necesarios. Este valor debe contener el tamaño del búfer pvData en la entrada. Si pvData es NULL (o si pvData no es NULL, pero demasiado pequeño de un búfer para contener los datos del Registro), al salir contendrá el tamaño necesario para contener los datos del Registro.

[in, out] pcbData

Tipo: DWORD*

Cuando esta función vuelve, contiene un puntero al tamaño de los datos, en bytes.

Valor devuelto

Tipo: LONG

Si se ejecuta correctamente, esta función devuelve ERROR_SUCCESS y todos los parámetros out solicitados. Devuelve ERROR_MORE_DATA si se produce un error en la función debido a un espacio insuficiente en un pvData no NULL proporcionado. En este caso, solo pdwType y pcbData pueden contener datos válidos, pvData no estará definido. De lo contrario, devuelve un código de error distinto de cero definido en Winerror.h . Puede usar la función FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para recuperar una descripción genérica del error.

Requisitos