Compartir a través de


Función SHRegSetValue (shlwapi.h)

No compatible.

Establece un valor del Registro.

Use RegSetValue en su lugar.

Sintaxis

LSTATUS SHRegSetValue(
  [in] HKEY    hkey,
  [in] LPCWSTR pszSubKey,
  [in] LPCWSTR pszValue,
  [in] SRRF    srrfFlags,
  [in] DWORD   dwType,
  [in] LPCVOID pvData,
  [in] DWORD   cbData
);

Parámetros

[in] hkey

Tipo: HKEY

Identificador de la clave abierta actualmente 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] pszSubKey

Tipo: LPCWSTR

Puntero a una cadena terminada en null que especifica la ruta de acceso relativa de hkey a la subclave desde la que se va a recuperar el valor. Este parámetro puede ser NULL o una cadena vacía, en cuyo caso los datos se recuperan de la ubicación hkey .

[in] pszValue

Tipo: LPCWSTR

Puntero a una cadena terminada en null que contiene el nombre del valor. Este parámetro puede ser NULL o una cadena vacía, en cuyo caso los datos se recuperan del valor Predeterminado.

[in] srrfFlags

Tipo: SRRF

Una o varias de las marcas SRRF que restringen los datos que se van a establecer. Se debe especificar al menos un valor de restricción de tipo (SRRF_RT).

[in] dwType

Tipo: DWORD

DWORD que indica el tipo de datos almacenados en el valor que se va a establecer. Cuando se usan valores predeterminados, dwType de entrada es el tipo del valor predeterminado. Para conocer los valores posibles, consulte Tipos de datos del Registro. Si no se establece la marca de SRRF_NOEXPAND, REG_EXPAND_SZ tipos se expanden automáticamente y se devuelven como REG_SZ. Si no se requiere información de tipo, este parámetro puede ser NULL.

[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.

[in] cbData

Tipo: DWORD

Tamaño del búfer de datos de origen pvData, en bytes. Este valor solo puede ser NULL si pvData es NULL.

Valor devuelto

Tipo: LONG

Devuelve ERROR_SUCCESS si se ejecuta correctamente o si 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 genérica del error.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h (incluya Shlwapi.h)
Archivo DLL Shlwapi.dll

Consulte también

RegSetKeyValue