Funzione CreateClusterNotifyPortV2 (clusapi.h)

Articolo
02/23/2024

Crea o modifica una porta di notifica. Per informazioni sulle porte di notifica, vedere Ricezione di eventi del cluster.

Sintassi

HCHANGE CreateClusterNotifyPortV2(
  [in] HCHANGE                hChange,
  [in] HCLUSTER               hCluster,
  [in] NOTIFY_FILTER_AND_TYPE *Filters,
  [in] DWORD                  dwFilterCount,
  [in] DWORD_PTR              dwNotifyKey
);

Parametri

[in] hChange

Handle per una porta di notifica o INVALID_HANDLE_VALUE, che indica che deve essere creato un nuovo handle. Se il parametro hChange è un handle esistente, gli eventi specificati nel parametro dwFilter vengono aggiunti alla porta di notifica.

[in] hCluster

Handle per il cluster da associare alla porta di notifica identificata dal parametro hChange o INVALID_HANDLE_VALUE, a indicare che la porta di notifica non deve essere associata a un cluster. Se il parametro hChange non è impostato su INVALID_HANDLE_VALUE, il parametro hCluster non può essere impostato su INVALID_HANDLE_VALUE.

[in] Filters

Puntatore alla struttura NOTIFY_FILTER_AND_TYPE che specifica il tipo di notifiche che la porta può accettare.

[in] dwFilterCount

Numero di filtri specificati dal parametro Filters .

[in] dwNotifyKey

Valore specificato dall'utente da associare al recupero delle notifiche dalla porta di notifica. Il parametro dwNotifyKey viene restituito da GetClusterNotifyV2 quando si verifica un evento di uno dei tipi specificati in Filters .

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce un handle di porta di notifica.

Se l'operazione non riesce, la funzione restituisce NULL. Per altre informazioni sull'errore, chiamare GetLastError.

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