Compartir a través de

Función ClusterOpenEnum (clusapi.h)

  • Artículo

Abre un enumerador para recorrer en iteración los objetos de clúster de un clúster. El tipo PCLUSAPI_CLUSTER_OPEN_ENUM define un puntero a esta función.

Sintaxis

HCLUSENUM ClusterOpenEnum(
  [in] HCLUSTER hCluster,
  [in] DWORD    dwType
);

Parámetros

[in] hCluster

Identificador de un clúster.

[in] dwType

Máscara de bits que describe el tipo de objetos que se van a enumerar. Uno o varios de los siguientes valores de la enumeración CLUSTER_ENUM son válidos.

CLUSTER_ENUM_NODE (1 (0x1))

Enumera los nodos del clúster.

CLUSTER_ENUM_RESTYPE (2 (0x2))

Enumera los tipos de recursos del clúster.

CLUSTER_ENUM_RESOURCE (4 (0x4))

Enumera los recursos del clúster.

CLUSTER_ENUM_GROUP (8 (0x8))

Enumera los grupos del clúster.

CLUSTER_ENUM_NETWORK (16 (0x10))

Enumera las redes del clúster.

CLUSTER_ENUM_NETINTERFACE (32 (0x20))

Enumera las interfaces de red del clúster.

CLUSTER_ENUM_SHARED_VOLUME_RESOURCE (1073741824 (0x40000000))

Enumera los volúmenes compartidos de clúster que usa el clúster.

Nota A diferencia de la mayoría de las máscaras de bits de enumeración, este valor se debe usar solo. No use el operador OR para combinarlo con otras máscaras de bits.
 
Windows Server 2008: El valor de CLUSTER_ENUM_SHARED_VOLUME_RESOURCE no se admite antes de Windows Server 2008 R2.

CLUSTER_ENUM_INTERNAL_NETWORK (2147483648 (0x80000000))

Enumera las redes que usa el clúster para la comunicación interna. Las redes se enumeran en orden de prioridad más alta a más baja, según lo establecido por SetClusterNetworkPriorityOrder.

Nota A diferencia de la mayoría de las máscaras de bits de enumeración, este valor se debe usar solo. No use el operador OR para combinarlo con otras máscaras de bits.
 

CLUSTER_ENUM_ALL ((CLUSTER_ENUM_NODE | CLUSTER_ENUM_RESTYPE | CLUSTER_ENUM_RESOURCE | CLUSTER_ENUM_GROUP | CLUSTER_ENUM_NETWORK | CLUSTER_ENUM_NETINTERFACE))

Enumera todos los objetos de clúster.

Valor devuelto

Si la operación se realiza correctamente, ClusterOpenEnum devuelve un identificador a un enumerador de clúster.

Si se produce un error en la operación, la función devuelve NULL. Para obtener más información sobre el error, llame a la función GetLastError.

Comentarios

Las aplicaciones llaman a la función ClusterOpenEnum para crear un tipo determinado de enumerador. ClusterOpenEnum puede crear enumeradores para recorrer en iteración grupos, nodos, tipos de recursos, recursos o todos ellos. Por ejemplo, una aplicación puede llamar a ClusterOpenEnum para obtener una enumeración de todos los nodos y grupos de un clúster especificando CLUSTER_ENUM_GROUP | CLUSTER_ENUM_NODE en el parámetro dwType . ClusterOpenEnum devuelve un identificador que se puede pasar a ClusterEnum para acceder a cada uno de los grupos de clústeres o nodos y a ClusterCloseEnum para liberar el enumerador.

Ejemplos

Vea Enumerar objetos.

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

Funciones de administración de clústeres

ClusterCloseEnum

ClusterEnum

SetClusterNetworkPriorityOrder