Funzione SetClusterQuorumResource (clusapi.h)

Articolo
03/09/2023

Stabilisce una risorsa come risorsa quorum per un cluster. Il tipo PCLUSAPI_SET_CLUSTER_QUORUM_RESOURCE definisce un puntatore a questa funzione.

Sintassi

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

Parametri

[in] hResource

Gestire la nuova risorsa quorum; o la risorsa quorum esistente quando dwMaxQuoLogSize è CLUS_NODE_MAJORITY_QUORUM.

[in, optional] lpszDeviceName

Determina la lettera di unità e il percorso che il servizio cluster userà per gestire i file quorum nella nuova risorsa quorum. Passare una stringa Unicode con terminazione Null o NULL, come indicato di seguito.

Se si specifica una lettera di unità nel percorso, il servizio cluster verificherà che la lettera di unità faccia riferimento a una partizione valida nella nuova risorsa quorum.
Se non si specifica una lettera di unità nel percorso, il servizio cluster userà una partizione predefinita nella nuova risorsa quorum (vedere di seguito).
Se NULL, il servizio cluster userà una partizione predefinita e un nome di percorso predefinito (vedere di seguito).

Il servizio Cluster usa la partizione contrassegnata come CLUSPROP_PIFLAG_DEFAULT_QUORUM come partizione predefinita (vedere CLUSPROP_PARTITION_INFO) oppure, se il flag non è stato trovato, la prima partizione NTFS disponibile nella nuova risorsa quorum.

Per il nome del percorso predefinito, il servizio cluster usa il nome del percorso precedente, se presente; in caso contrario, usa "MSCS".

[in] dwMaxQuoLogSize

Valore del tipo quorum. Specificare una delle tre costanti elencate. Quando si specifica CLUS_NODE_MAJORITY_QUORUM, hResource deve fare riferimento alla risorsa quorum esistente.

CLUS_HYBRID_QUORUM (1024 (0x400))

CLUS_NODE_MAJORITY_QUORUM (0 (0x0))

CLUS_LEGACY_QUORUM (4194304 (0x400000))

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce ERROR_SUCCESS (0).

Se l'operazione non riesce, la funzione restituisce un codice di errore di sistema. Di seguito è riportato un possibile codice di errore.

Codice/valore restituito	Descrizione
ERROR_RESOURCE_NOT_ONLINE 5004 (0x138C)	La risorsa quorum non è online.

Commenti

Non chiamare SetClusterQuorumResource da una DLL di risorse. Per altre informazioni, vedere Chiamate di funzione da evitare nelle DLL delle risorse.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Piattaforma di destinazione	Windows
Intestazione	clusapi.h
Libreria	ClusAPI.lib
DLL	ClusAPI.dll

Vedi anche

GetClusterQuorumResource

Condividi tramite