Compartir a través de

Función SetClusterQuorumResource (clusapi.h)

  • Artículo

Establece un recurso como recurso de cuórum para un clúster. El tipo PCLUSAPI_SET_CLUSTER_QUORUM_RESOURCE define un puntero a esta función.

Sintaxis

DWORD SetClusterQuorumResource(
  [in]           HRESOURCE hResource,
  [in, optional] LPCWSTR   lpszDeviceName,
  [in]           DWORD     dwMaxQuoLogSize
);

Parámetros

[in] hResource

Controlar el nuevo recurso de cuórum; o el recurso de cuórum existente cuando dwMaxQuoLogSize está CLUS_NODE_MAJORITY_QUORUM.

[in, optional] lpszDeviceName

Determina la letra de unidad y la ruta de acceso que usará el servicio de clúster para mantener los archivos de cuórum en el nuevo recurso de cuórum. Pase una cadena Unicode terminada en null o NULL, como se indica a continuación.

  • Si especifica una letra de unidad en la ruta de acceso, el servicio de clúster comprobará que la letra de unidad hace referencia a una partición válida en el nuevo recurso de cuórum.
  • Si no especifica una letra de unidad en la ruta de acceso, el servicio de clúster usará una partición predeterminada en el nuevo recurso de cuórum (consulte a continuación).
  • Si es NULL, el servicio de clúster usará una partición predeterminada y un nombre de ruta de acceso predeterminado (consulte a continuación).
El servicio de clúster usa la partición marcada como CLUSPROP_PIFLAG_DEFAULT_QUORUM como partición predeterminada (consulte CLUSPROP_PARTITION_INFO) o, si no se encuentra la marca, la primera partición NTFS disponible en el nuevo recurso de cuórum.

Para el nombre de ruta de acceso predeterminado, el servicio de clúster usa el nombre de ruta de acceso anterior si existe uno; de lo contrario, usa "MSCS".

[in] dwMaxQuoLogSize

Valor del tipo de cuórum. Especifique una de las tres constantes enumeradas. Al especificar CLUS_NODE_MAJORITY_QUORUM, hResource debe hacer referencia al recurso de cuórum existente.

CLUS_HYBRID_QUORUM (1024 (0x400))

CLUS_NODE_MAJORITY_QUORUM (0 (0x0))

CLUS_LEGACY_QUORUM (4194304 (0x400000))

Valor devuelto

Si la operación se realiza correctamente, la función devuelve ERROR_SUCCESS (0).

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 un posible código de error.

Código o valor devuelto Descripción
ERROR_RESOURCE_NOT_ONLINE
5004 (0x138C)
 El recurso de cuórum no está en línea.

Comentarios

No llame a SetClusterQuorumResource 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

GetClusterQuorumResource