Compartir a través de

Función ResUtilSetExpandSzValue (resapi.h)

  • Artículo

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

Sintaxis

DWORD ResUtilSetExpandSzValue(
  [in]                HKEY    hkeyClusterKey,
  [in]                LPCWSTR pszValueName,
  [in]                LPCWSTR pszNewValue,
  [in, out, optional] LPWSTR  *ppszOutString
);

Parámetros

[in] hkeyClusterKey

Clave que identifica la ubicación del valor de cadena expandible 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 expandible.

[in, out, optional] ppszOutString

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.

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 ResUtilSetExpandSzValue asigna memoria para el nuevo valor y llama a la función de API de clústerClusterRegSetValue.

Un valor de cadena expandible contiene datos que representan una cadena Unicode terminada en null que contiene referencias no expandidas a variables de entorno como "%SystemRoot%".

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

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

Se puede llamar a ResUtilSetExpandSzValue 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

ResUtilSetMultiSzValue

ResUtilSetSzValue