Compartir a través de

Función ResUtilGetBinaryValue (resapi.h)

  • Artículo

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

Sintaxis

DWORD ResUtilGetBinaryValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPBYTE  *ppbOutValue,
  [out]           LPDWORD pcbOutValueSize
);

Parámetros

[in] hkeyClusterKey

Clave en la base de datos del clúster que identifica la ubicación del valor que se va a recuperar.

[in] pszValueName

Puntero a una cadena Unicode terminada en null que contiene el nombre del valor que se va a recuperar.

[out, optional] ppbOutValue

Dirección del puntero al valor recuperado.

[out] pcbOutValueSize

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

Valor devuelto

Si las operaciones se realizan 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 al asignar memoria para el valor.

Comentarios

La función de utilidad ResUtilGetBinaryValue se encarga de asignar la memoria necesaria para el valor y, a continuación, llama a la función de API de clústerClusterRegQueryValue. Cuando haya terminado con la memoria asignada, debe llamar a la función LocalFree para liberarla.

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

ClusterRegQueryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetMultiSzValue

ResUtilGetSzValue