Compartir a través de

Función ResUtilSetBinaryValue (resapi.h)

  • Artículo

Establece un valor binario en la base de datos del clúster.

Sintaxis

DWORD ResUtilSetBinaryValue(
  [in]                HKEY         hkeyClusterKey,
  [in]                LPCWSTR      pszValueName,
  [in]                const LPBYTE pbNewValue,
  [in]                DWORD        cbNewValueSize,
  [in, out, optional] LPBYTE       *ppbOutValue,
  [in, out]           LPDWORD      pcbOutValueSize
);

Parámetros

[in] hkeyClusterKey

Clave que identifica la ubicación del valor binario 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] pbNewValue

Puntero al nuevo valor binario.

[in] cbNewValueSize

Tamaño del nuevo valor binario.

[in, out, optional] ppbOutValue

Dirección de un puntero al nuevo valor binario.

[in, out] pcbOutValueSize

Puntero a un DWORD en el que se devuelve el tamaño en bytes del valor al que apunta ppbOutValue .

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 código de error posible.

Código devuelto Descripción
ERROR_NOT_ENOUGH_MEMORY
 Error durante la asignación de memoria.

Comentarios

La función de utilidad ResUtilSetBinaryValue asigna memoria para el puntero ppbOutValue mediante la función LocalAlloc, llama a la función Cluster API ClusterRegSetValue y, a continuación, copia el nuevo valor en este búfer. Si el puntero no es NULL, ResUtilSetBinaryValue también lo desasigna. Como autores de llamadas de esta función, es responsable de desasignar el búfer mediante la función LocalFree.

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

ResUtilSetBinaryValue se puede llamar de forma segura desde cualquier otra función de punto de entrada dll de recurso 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

ResUtilSetDwordValue

ResUtilSetExpandSzValue

ResUtilSetMultiSzValue

ResUtilSetSzValue