Función SHRegEnumUSValueA (shlwapi.h)

Enumera los valores de la subclave del Registro especificada en un subárbol específico del usuario (HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE).

Sintaxis

LSTATUS SHRegEnumUSValueA(
  [in]                HUSKEY          hUSkey,
  [in]                DWORD           dwIndex,
  [out]               LPSTR           pszValueName,
  [in, out]           LPDWORD         pcchValueName,
  [out, optional]     LPDWORD         pdwType,
  [out, optional]     void            *pvData,
  [in, out, optional] LPDWORD         pcbData,
  [in]                SHREGENUM_FLAGS enumRegFlags
);

Parámetros

[in] hUSkey

Tipo: HUSKEY

Identificador de una subclave del Registro abierta actualmente. La subclave debe haberse abierto con el derecho de acceso KEY_SET_VALUE. Para obtener más información, consulte Derechos de acceso y seguridad de clave del Registro.

Este identificador se puede obtener a través de la función SHRegOpenUSKey .

[in] dwIndex

Tipo: DWORD

Índice del valor que se va a recuperar. Este parámetro debe ser cero para la primera llamada e incrementada para las llamadas posteriores.

[out] pszValueName

Tipo: LPTSTR

Puntero a un búfer de caracteres que recibe el nombre del valor enumerado. El tamaño de este búfer se especifica en pcchValueNameLen.

[in, out] pcchValueName

Tipo: LPDWORD

Puntero a un DWORD que, en la entrada, contiene el tamaño del búfer en pszValueName, en caracteres. Al salir, contiene el número de caracteres que se copiaron en pszValueName.

[out, optional] pdwType

Tipo: LPDWORD

Puntero a un DWORD que recibe el tipo de datos del valor. Estos son los mismos valores que los descritos en el parámetro lpType de RegEnumValue.

[out, optional] pvData

Tipo: void*

Puntero a un búfer que recibe los datos de la entrada de valor. El tamaño de este búfer se especifica en pcbData. Este parámetro puede ser NULL si los datos no son necesarios.

[in, out, optional] pcbData

Tipo: LPDWORD

Puntero a un DWORD que, en la entrada, contiene el tamaño del búfer en pvData. Al salir, contiene el número de bytes que se copiaron en pvData.

[in] enumRegFlags

Tipo: SHREGENUM_FLAGS

Uno de los SHREGENUM_FLAGS que especifica la clave base en la que debe realizarse la enumeración.

Valor devuelto

Tipo: LSTATUS

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

Comentarios

Requisitos