Metodo ISSONotification.ReceiveNotification

Articolo
12/14/2023

Riceve una notifica dal sistema ENTSSO, ad esempio modifiche della password.

Sintassi

  
HRESULT ReceiveNotification(  
ULONG ulNotificationFlagsIn,  
SReceiveNotification* pReceiveNotification,  
GUID* pguidTrackingId  
);

Parametri

bstrAdapterName
[in] Nome univoco dell'adapter.

ulNotificationFlagsIn
[in] Flag di notifica per controllare la notifica, dall'enumerazione SSO_NOTIFICATION_FLAG.

pReceiveNotification
[in] Puntatore per la notifica ricevuta.

pguidTrackingId
[out] ID di rilevamento. Il sistema ENTSSO genererà un ID di rilevamento e lo restituirà al chiamante. L'ID rilevamento viene utilizzato a scopo di controllo e può essere utilizzato dall'adapter per la correlazione di risposte e richieste. Questo parametro può essere NULL se l'ID rilevamento non è richiesto dall'adapter.

Valore restituito

Questo metodo restituisce un HRESULT che indica se il metodo viene completato in modo corretto. Per ulteriori informazioni, vedere la sezione relativa ai valori di errore.

Valori di errore

Questo metodo restituisce un HRESULT contenente uno dei valori riportati nella tabella seguente.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_ACCESSDENIED	Accesso negato.
ENTSSO_E_NO_SERVER	Impossibile contattare il server ENTSSO. Verificare che il servizio ENTSSO sia in esecuzione.
ENTSSO_E_NO_NOTIFICATIONS	Non sono presenti notifiche da ricevere.
ENTSSO_E_WRONG_STATE	Il metodo è stato chiamato con uno stato errato.

Commenti

È possibile usare ReceiveNotification per ricevere sia le modifiche della password che altre notifiche dal sistema ENTSSO.

È possibile chiamare ReceiveNotification con o senza un flag WAIT. Se si specifica il flag WAIT, ReceiveNotification si blocca fino a quando non sarà disponibile una notifica. In questo modo è possibile determinare se si vuole dedicare un thread per la ricezione di notifiche dal servizio ENTSSO o se si vuole usare l'handle eventi restituito da InitializeAdapter per eseguire attese personalizzate, condivise con altri eventi.

Se ReceiveNotification è in attesa quando si chiama ShutdownAdapter, ReceiveNotification restituisce una notifica SHUTDOWN come ultima notifica. La notifica SHUTDOWN ha la precedenza su tutte le altre notifiche in sospeso.

È possibile che più thread chiami ReceiveNotification per lo stesso nome di adattatore. In questo caso, la richiesta viene a thread singolo nel servizio ENTSSO e una sola receiveNotification viene completata con informazioni valide. I thread vengono completati con la successiva notifica o NESSUNO. Il motivo di questo comportamento sta nel fatto che ognuno di questi thread attende lo stesso evento.

Requisiti

Piattaforme: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 e Windows 10

Vedere anche

Interfaccia ISSONotification (COM)
Membri ISSONotification
Programmazione con Enterprise Single Sign-On

Condividi tramite