Funzione GetClusterNotifyV2 (clusapi.h)

Articolo
03/08/2023

Recupera informazioni sull'evento di notifica successivo per una porta di notifica.

Sintassi

DWORD GetClusterNotifyV2(
  [in]                HCHANGE                 hChange,
  [out]               DWORD_PTR               *lpdwNotifyKey,
  [in, out, optional] PNOTIFY_FILTER_AND_TYPE pFilterAndType,
  [in, out, optional] BYTE                    *buffer,
  [in, out, optional] LPDWORD                 lpbBufferSize,
  [in, out, optional] LPWSTR                  lpszObjectId,
  [in, out, optional] LPDWORD                 lpcchObjectId,
  [in, out, optional] LPWSTR                  lpszParentId,
  [in, out, optional] LPDWORD                 lpcchParentId,
  [in, out, optional] LPWSTR                  lpszName,
  [in, out, optional] LPDWORD                 lpcchName,
  [in, out, optional] LPWSTR                  lpszType,
  [in, out, optional] LPDWORD                 lpcchType,
  [in, optional]      DWORD                   dwMilliseconds
);

Parametri

[in] hChange

Handle alla porta di notifica. Questo handle viene creato dalla funzione CreateClusterNotifyPortV2 .

[out] lpdwNotifyKey

Puntatore alla chiave di notifica per la porta di notifica.

[in, out, optional] pFilterAndType

Puntatore a una struttura NOTIFY_FILTER_AND_TYPE che descrive l'evento di notifica successivo per la porta di notifica.

[in, out, optional] buffer

Puntatore a un buffer per l'evento di notifica.

[in, out, optional] lpbBufferSize

Puntatore alle dimensioni del parametro del buffer , in byte.

[in, out, optional] lpszObjectId

Puntatore a una stringa Unicode con l'ID dell'oggetto cluster che ha attivato l'evento. La stringa termina con un carattere Null terminante.

[in, out, optional] lpcchObjectId

In input, un puntatore a un DWORD che specifica il numero massimo di caratteri che il parametro lpszObjectId può contenere, incluso il carattere Null di terminazione. Nell'output, un puntatore a un DWORD che specifica il numero di caratteri ricevuti da lpszObjectId , esclusi il carattere null terminante.

[in, out, optional] lpszParentId

Puntatore a una stringa Unicode con l'ID dell'oggetto padre all'oggetto cluster che ha attivato l'evento. La stringa termina con un carattere Null terminante.

[in, out, optional] lpcchParentId

In input, un puntatore a un DWORD che specifica il numero massimo di caratteri che il parametro lpszParentId può contenere, incluso il carattere Null di terminazione. Nell'output, un puntatore a un DWORD che specifica il numero di caratteri ricevuti da lpszParentId , escluso il carattere Null di terminazione.

[in, out, optional] lpszName

Puntatore a una stringa Unicode contenente il nome dell'oggetto cluster che ha attivato l'evento. La stringa termina con un carattere Null terminante.

[in, out, optional] lpcchName

In input, un puntatore a un DWORD che specifica il numero massimo di caratteri che il parametro lpszName può contenere, incluso il carattere Null di terminazione. Nell'output, un puntatore a una DWORD che specifica il numero di caratteri ricevuti da lpszName , esclusi il carattere null terminante.

[in, out, optional] lpszType

Puntatore a una stringa Unicode contenente il tipo di oggetto cluster che ha attivato l'evento. La stringa termina con un carattere Null terminante.

[in, out, optional] lpcchType

In input, un puntatore a un DWORD che specifica il numero massimo di caratteri che il parametro lpszType può contenere, incluso il carattere Null di terminazione. Nell'output, un puntatore a un DWORD che specifica il numero di caratteri ricevuti da lpszType , escluso il carattere null terminante.

[in, optional] dwMilliseconds

Valore di timeout che specifica quanto tempo il chiamante è disposto ad attendere la notifica.

Valore restituito

se l'operazione ha esito positivo, questa funzione restituisce ERROR_SUCCESS.

Se l'operazione ha esito negativo, questa funzione restituisce uno dei codici di errore di sistema seguenti.

Codice/valore restituito	Descrizione
ERROR_INVALID_HANDLE 6	L'handle rappresentato nel parametro hChange non è valido o è stato chiuso da un altro thread.
WAIT_TIMEOUT 258 (0x102)	Timeout della chiamata prima che la notifica venga restituita correttamente.
ERROR_MORE_DATA 234 (0xEA)	Il buffer a cui punta il parametro lpszName non è abbastanza grande per contenere il risultato. Il parametro lpcchName restituisce il numero di caratteri nel risultato, escluso il carattere null terminante.

Requisiti

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

Vedi anche

Funzione di gestione del cluster di failover

Condividi tramite