Funzione GetClusterQuorumResource (clusapi.h)

Articolo
02/28/2024

Restituisce il nome della risorsa quorum di un cluster. Il tipo PCLUSAPI_GET_CLUSTER_QUORUM_RESOURCE definisce un puntatore a questa funzione.

Sintassi

DWORD GetClusterQuorumResource(
  [in]      HCLUSTER hCluster,
  [out]     LPWSTR   lpszResourceName,
  [in, out] LPDWORD  lpcchResourceName,
  [out]     LPWSTR   lpszDeviceName,
  [in, out] LPDWORD  lpcchDeviceName,
  [out]     LPDWORD  lpdwMaxQuorumLogSize
);

Parametri

[in] hCluster

Gestire in un cluster esistente.

[out] lpszResourceName

Puntatore a una stringa Unicode con terminazione null contenente il nome della risorsa quorum del cluster. Il nome viene letto dalla proprietà comune Name della risorsa quorum. Non passare NULL per questo parametro.

[in, out] lpcchResourceName

Puntatore alla dimensione del buffer lpszResourceName come conteggio dei caratteri. In input specificare il numero massimo di caratteri che il buffer può contenere, incluso il valore NULL di terminazione. Nell'output specifica il numero di caratteri nel nome risultante, escluse le terminazioni NULL.

[out] lpszDeviceName

Puntatore a una stringa Unicode con terminazione null contenente il percorso del percorso dei file di log del quorum gestiti dal servizio cluster. Non passare NULL per questo parametro.

[in, out] lpcchDeviceName

Puntatore alla dimensione del buffer lpszDeviceName come conteggio dei caratteri. In input specificare il numero massimo di caratteri che il buffer può contenere, incluso il valore NULL di terminazione. Nell'output specifica il numero di caratteri nel nome risultante, escluse le terminazioni NULL.

[out] lpdwMaxQuorumLogSize

Puntatore alla dimensione massima (in byte) del log gestito dalla risorsa quorum. Non passare NULL per questo parametro.

Valore restituito

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

Se l'operazione ha esito negativo, la funzione restituisce un codice di errore di sistema. Di seguito è riportato uno dei valori possibili.

Codice restituito	Descrizione
ERROR_MORE_DATA	Il buffer lpszResourceName o lpszDeviceName non è abbastanza grande per contenere il risultato. I parametri lpcchResourceName e lpcchDeviceName restituiscono il numero di caratteri nel risultato, escluse le terminazioni NULL.

Commenti

Si noti che lpcchName fa riferimento a un conteggio di caratteri e non a un conteggio di byte e che la dimensione restituita non include il valore NULL terminante nel conteggio. Per altre informazioni sul ridimensionamento dei buffer, vedere Convenzioni delle dimensioni dei dati.

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

Nome

SetClusterQuorumResource

Condividi tramite