Compartir a través de

Función GetClusterInformation (clusapi.h)

  • Artículo

Recupera el nombre y la versión de un clúster . El tipo PCLUSAPI_GET_CLUSTER_INFORMATION define un puntero a esta función.

Sintaxis

DWORD GetClusterInformation(
  [in]            HCLUSTER             hCluster,
  [out]           LPWSTR               lpszClusterName,
  [in, out]       LPDWORD              lpcchClusterName,
  [out, optional] LPCLUSTERVERSIONINFO lpClusterInfo
);

Parámetros

[in] hCluster

Identificador de un clúster.

[out] lpszClusterName

Puntero a una cadena Unicode terminada en null que contiene el nombre del clúster identificado por hCluster.

[in, out] lpcchClusterName

Puntero al tamaño del búfer lpszClusterName 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, optional] lpClusterInfo

Null o un puntero a una estructura CLUSTERVERSIONINFO que describe la versión del servicio de clúster. Cuando lpClusterInfo no es NULL, el miembro dwVersionInfoSize de esta estructura debe establecerse de la siguiente manera: lpClusterInfo->dwVersionInfoSize = sizeof(CLUSTERVERSIONINFO);

Valor devuelto

Si la operación se realiza correctamente, la función devuelve ERROR_SUCCESS (0).

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 al que apunta lpszClusterName no es lo suficientemente grande como para contener el resultado. El parámetro lpcchClusterName devuelve el número de caracteres del resultado, excepto el valor NULL de terminación.

Comentarios

Tenga en cuenta que lpcchClusterName 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

CLUSTERVERSIONINFO