Compartir a través de

Función GetClusterNetInterface (clusapi.h)

  • Artículo

Devuelve el nombre de la interfaz de un nodo a una red de un clúster. El tipo PCLUSAPI_GET_CLUSTER_NET_INTERFACE define un puntero a esta función.

Sintaxis

DWORD GetClusterNetInterface(
  [in]      HCLUSTER hCluster,
  [in]      LPCWSTR  lpszNodeName,
  [in]      LPCWSTR  lpszNetworkName,
  [out]     LPWSTR   lpszInterfaceName,
  [in, out] LPDWORD  lpcchInterfaceName
);

Parámetros

[in] hCluster

Identificador de un clúster.

[in] lpszNodeName

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

[in] lpszNetworkName

Puntero a una cadena Unicode terminada en null que contiene el nombre de la red.

[out] lpszInterfaceName

Puntero a un búfer de salida que contiene el nombre de la interfaz de red.

[in, out] lpcchInterfaceName

Puntero al tamaño del búfer lpszInterfaceName 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

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

Comentarios

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

OpenCluster