Compartir a través de

Función GetClusterNetworkId (clusapi.h)

  • Artículo

Devuelve el identificador de una red. El tipo PCLUSAPI_GET_CLUSTER_NETWORK_ID define un puntero a esta función.

Sintaxis

DWORD GetClusterNetworkId(
  [in]      HNETWORK hNetwork,
  [out]     LPWSTR   lpszNetworkId,
  [in, out] LPDWORD  lpcchName
);

Parámetros

[in] hNetwork

Identificador de una red.

[out] lpszNetworkId

Puntero al identificador de la red asociada a hNetwork, incluido el carácter de terminación null.

[in, out] lpcchName

Puntero al tamaño del búfer lpszNetworkID 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 lpszNetworkID no es lo suficientemente grande como para contener el resultado. El parámetro lpcchNetworkID devuelve el número de caracteres del resultado, excepto el valor NULL de terminación.

Comentarios

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

OpenClusterNetwork