Compartir a través de


Función SetClusterName (clusapi.h)

Establece el nombre de un clúster. El tipo PCLUSAPI_SetClusterName define un puntero a esta función.

Sintaxis

DWORD SetClusterName(
  [in] HCLUSTER hCluster,
  [in] LPCWSTR  lpszNewClusterName
);

Parámetros

[in] hCluster

Identificador de un clúster al que se va a cambiar el nombre.

[in] lpszNewClusterName

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

Valor devuelto

Si la operación se realiza correctamente, la función devuelve ERROR_RESOURCE_PROPERTIES_STORED.

Si se produce un error en la operación, la función devuelve un código de error del sistema.

Comentarios

El nombre del clúster se almacena en la propiedad privada Name del recurso nombre de red principal (es decir, el recurso Nombre de red del clúster). Debido a las posibles dependencias de este recurso, el cambio no es efectivo hasta que el recurso Nombre de red se vuelve a poner en línea.

No llame a SetClusterName desde un archivo DLL de recursos. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.

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

Nombre