Función GetClusterNodeId (clusapi.h)
Devuelve el identificador único de un nodo de clúster. El tipo PCLUSAPI_GET_CLUSTER_NODE_ID define un puntero a esta función.
Sintaxis
DWORD GetClusterNodeId(
[in, optional] HNODE hNode,
[out] LPWSTR lpszNodeId,
[in, out] LPDWORD lpcchName
);
Parámetros
[in, optional] hNode
Controle al nodo con el identificador que se va a devolver o NULL. Si hNode se establece en NULL, el identificador de nodo del nodo en el que se ejecuta la aplicación se devuelve en el contenido de lpszNodeId.
[out] lpszNodeId
Este parámetro apunta a un búfer que recibe el identificador único de hNode, incluido el carácter NULL de terminación.
[in, out] lpcchName
En la entrada, puntero al recuento de caracteres del búfer al que apunta el parámetro lpszNodeId , incluido el terminador NULL . En la salida, puntero al recuento de caracteres almacenados en el búfer, excepto el terminador NULL .
Valor devuelto
Esta función devuelve un código de error del sistema. Los posibles valores son los 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 lpszNodeId no es lo suficientemente largo como para contener el número necesario de caracteres. GetClusterNodeId establece el contenido de lpcchName en la longitud necesaria. |
Comentarios
El tipo PCLUSAPI_GET_CLUSTER_NODE_ID define un puntero a esta función.
Si hNode se establece en NULL y el autor de la llamada se ejecuta en un nodo de clúster activo, la función GetClusterNodeId devuelve el identificador del nodo en el que se ejecuta la aplicación. Establecer hNode en NULL es una manera cómoda de que los archivos DLL de recursos determinen el identificador de nodo del nodo en el que se ejecutan. La macro GetCurrentClusterNodeId se puede usar en lugar de pasar NULL para el parámetro hNode .
Un identificador de nodo de clúster es un identificador único que no cambia incluso si se cambia el nombre del nodo.
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 |