Función ResUtilSetSzValue (resapi.h)
Establece un valor de cadena en la base de datos del clúster. El tipo PRESUTIL_SET_SZ_VALUE define un puntero a esta función.
Sintaxis
DWORD ResUtilSetSzValue(
[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 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.
[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 al intentar asignar memoria. |
Comentarios
La función de utilidad ResUtilSetSzValue asigna memoria para el nuevo valor y llama a la función clusterRegSetValue de la API de clúster. Si es necesario, se desasigna un valor anterior. El nuevo valor se copia en el contenido de ppszOutValue.
Asegúrese de llamar a LocalFree en *ppszOutValue para evitar pérdidas de memoria.
No llame a ResUtilSetSzValue desde las siguientes funciones de punto de entrada dll de recursos:
Se puede llamar a ResUtilSetSzValue 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
| 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 |