Compartir a través de

Función ClusterNetInterfaceEnum (clusapi.h)

  • Artículo

Enumera las interfaces de red instaladas en un clúster y devuelve un nombre con cada llamada.

Sintaxis

DWORD ClusterNetInterfaceEnum(
  [in]      HNETINTERFACEENUM hNetInterfaceEnum,
  [in]      DWORD             dwIndex,
  [out]     LPWSTR            lpszName,
  [in, out] LPDWORD           lpcchName
);

Parámetros

[in] hNetInterfaceEnum

Identificador de un objeto de enumeración existente devuelto originalmente por la función ClusterNetInterfaceOpenEnum .

[in] dwIndex

Índice usado para identificar la entrada que se va a enumerar. Este parámetro debe ser cero para la primera llamada y, a continuación, incrementarse para cada llamada posterior.

[out] lpszName

Puntero a una cadena Unicode terminada en null que contiene el nombre del objeto devuelto.

[in, out] lpcchName

Puntero al tamaño, en caracteres, del búfer lpszName . 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, indica el número de caracteres en el nombre resultante, excepto el valor NULL de terminación.

Valor devuelto

La función devuelve uno de los valores siguientes.

Código o valor devuelto Descripción
ERROR_SUCCESS
0
 La operación se ha completado correctamente.
ERROR_NO_MORE_ITEMS
259 (0x103)
 No más datos disponibles. Este valor se devuelve si no hay más objetos que se van a devolver.
ERROR_MORE_DATA
234 (0xEA)
 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 lpszName 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.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Encabezado clusapi.h
Library ClusAPI.lib
Archivo DLL ClusAPI.dll