Compartir a través de

Función GetClusterQuorumResource (clusapi.h)

  • Artículo

Devuelve el nombre del recurso de cuórum de un clúster. El tipo PCLUSAPI_GET_CLUSTER_QUORUM_RESOURCE define un puntero a esta función.

Sintaxis

DWORD GetClusterQuorumResource(
  [in]      HCLUSTER hCluster,
  [out]     LPWSTR   lpszResourceName,
  [in, out] LPDWORD  lpcchResourceName,
  [out]     LPWSTR   lpszDeviceName,
  [in, out] LPDWORD  lpcchDeviceName,
  [out]     LPDWORD  lpdwMaxQuorumLogSize
);

Parámetros

[in] hCluster

Identificador de un clúster existente.

[out] lpszResourceName

Puntero a una cadena Unicode terminada en null que contiene el nombre del recurso de cuórum del clúster. El nombre se lee de la propiedad común Name del recurso de cuórum. No pase NULL para este parámetro.

[in, out] lpcchResourceName

Puntero al tamaño del búfer lpszResourceName como recuento de caracteres. En la entrada, especifique el número máximo de caracteres que puede contener el búfer, incluido el valor NULL de terminación. En la salida, especifica el número de caracteres en el nombre resultante, excepto el valor NULL de terminación.

[out] lpszDeviceName

Puntero a una cadena Unicode terminada en null que contiene la ruta de acceso a la ubicación de los archivos de registro de cuórum mantenidos por el servicio de clúster. No pase NULL para este parámetro.

[in, out] lpcchDeviceName

Puntero al tamaño del búfer lpszDeviceName como recuento de caracteres. En la entrada, especifique el número máximo de caracteres que puede contener el búfer, incluido el valor NULL de terminación. En la salida, especifica el número de caracteres en el nombre resultante, excepto el valor NULL de terminación.

[out] lpdwMaxQuorumLogSize

Puntero al tamaño máximo (en bytes) del registro que mantiene el recurso de cuórum. No pase NULL para este parámetro.

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 uno de los valores posibles.

Código devuelto Descripción
ERROR_MORE_DATA
 El búfer lpszResourceName o lpszDeviceName no es lo suficientemente grande como para contener el resultado. Los parámetros lpcchResourceName y lpcchDeviceName devuelven el número de caracteres del resultado, excepto el valor NULL de terminación.

Comentarios

Tenga en cuenta que lpcchName hace referencia a un recuento de caracteres y no a un recuento de bytes, y que el tamaño devuelto no incluye el valor NULL de terminación en el recuento. Para obtener más información sobre los búferes de tamaño, consulte Convenciones de tamaño de datos.

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 clusapi.h
Library ClusAPI.lib
Archivo DLL ClusAPI.dll

Consulte también

Nombre

SetClusterQuorumResource