Función ClusterGroupEnum (clusapi.h)
Enumera los recursos de un grupo o los nodos que son los propietarios preferidos de un grupo y devuelve el nombre del recurso o nodo con cada llamada. El tipo PCLUSAPI_CLUSTER_GROUP_ENUM define un puntero a esta función.
Sintaxis
DWORD ClusterGroupEnum(
[in] HGROUPENUM hGroupEnum,
[in] DWORD dwIndex,
[out] LPDWORD lpdwType,
[out] LPWSTR lpszResourceName,
[in, out] LPDWORD lpcchName
);
Parámetros
[in] hGroupEnum
Identificador de enumeración de grupo devuelto por la función ClusterGroupOpenEnum .
[in] dwIndex
Índice del recurso o nodo que se va a devolver. Este parámetro debe ser cero para la primera llamada a ClusterGroupEnum y, a continuación, incrementarse para las llamadas posteriores.
[out] lpdwType
Puntero al tipo de objeto devuelto por ClusterGroupEnum. Los siguientes son valores válidos de la enumeración CLUSTER_GROUP_ENUM .
CLUSTER_GROUP_ENUM_CONTAINS (1)
El objeto es uno de los recursos del grupo.
CLUSTER_GROUP_ENUM_NODES (2)
El objeto es uno de los nodos de la lista de propietarios preferidos del grupo.
[out] lpszResourceName
Puntero a una cadena Unicode terminada en null que contiene el nombre del recurso o nodo devuelto.
[in, out] lpcchName
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.
Valor devuelto
La función puede devolver uno de los valores siguientes.
| Código o valor devuelto | Descripción |
|---|---|
|
La operación se ha completado correctamente. |
|
More data is available (Hyper-V no pudo generar el conjunto de instantáneas de VSS para la máquina virtual: hay más datos disponibles). Este valor se devuelve si el búfer al que apunta lpszResourceName no es lo suficientemente grande como para contener el resultado. El parámetro lpcchName devuelve el número de caracteres del resultado, excepto el valor NULL de terminación. |
|
No más datos disponibles. Este valor se devuelve si no hay más recursos o nodos que se van a devolver. |
Si la operación no se realizó correctamente debido a un problema distinto de los descritos con los valores de ERROR_NO_MORE_ITEMS o ERROR_MORE_DATA , ClusterGroupEnum devuelve un código de error del sistema.
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.
No llame a ClusterGroupEnum desde ninguna función de punto de entrada dll de recursos. ClusterGroupEnum se puede llamar de forma segura desde un subproceso de trabajo. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.
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 |