Compartir a través de

Función ResUtilSetMultiSzValue (resapi.h)

  • Artículo

Establece un valor de cadena múltiple en la base de datos del clúster. El tipo PRESUTIL_SET_MULTI_SZ_VALUE define un puntero a esta función.

Sintaxis

DWORD ResUtilSetMultiSzValue(
  [in]                HKEY    hkeyClusterKey,
  [in]                LPCWSTR pszValueName,
  [in]                LPCWSTR pszNewValue,
  [in]                DWORD   cbNewValueSize,
  [out, optional]     LPWSTR  *ppszOutValue,
  [in, out, optional] LPDWORD pcbOutValueSize
);

Parámetros

[in] hkeyClusterKey

Clave que identifica la ubicación del valor de cadena múltiple en la base de datos del clúster.

[in] pszValueName

Cadena Unicode terminada en NULL que contiene el nombre del valor que se va a actualizar.

[in] pszNewValue

Puntero al nuevo valor de cadena múltiple.

[in] cbNewValueSize

Tamaño del nuevo valor.

[out, optional] ppszOutValue

Puntero a un puntero de cadena que recibe una copia del valor actualizado. Si se usa, los autores de la llamada deben llamar a LocalFree en *ppszOutValue.

[in, out, optional] pcbOutValueSize

Puntero que recibe el tamaño del nuevo valor.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve ERROR_SUCCESS.

Si se produce un error en la operación, la función devuelve un código de error del sistema. A continuación se muestra un posible código de error.

Código devuelto Descripción
ERROR_NOT_ENOUGH_MEMORY
 Error al intentar asignar memoria.

Comentarios

La función de utilidad ResUtilSetMultiSzValue asigna memoria para el nuevo valor y llama a la función cluster API ClusterRegSetValue.

Un valor de cadena múltiple es una cadena grande que contiene cadenas Unicode más pequeñas, contiguas y terminadas en null y termina con un carácter nulo adicional después de la última cadena.

Asegúrese de llamar a LocalFree en *ppszOutValue para evitar pérdidas de memoria.

No llame a ResUtilSetMultiSzValue desde las siguientes funciones de punto de entrada dll de recursos:

ResUtilSetMultiSzValue se puede llamar de forma segura desde cualquier otra función de punto de entrada dll de recursos o desde un subproceso de trabajo. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de destino Windows
Encabezado resapi.h
Library ResUtils.lib
Archivo DLL ResUtils.dll

Consulte también

ClusterRegSetValue

ResUtilSetBinaryValue

ResUtilSetDwordValue

ResUtilSetExpandSzValue

ResUtilSetSzValue