Metodo ISSOWrapper.ReceiveNotification
Riceve una notifica per l'adapter dal servizio ENTSSO.
Sintassi
void ReceiveNotification(
ULONG ulNotificationFlagsIn,
GUID guidTrackingIdIn,
out ULONG *pulNotificationType,
out ULONG *pulNotificationFlagsOut,
out BSTR *pbstrExternalAccount,
out BSTR *pbstrNewExternalPassword,
out BSTR *pbstrOldExternalPassword,
out ULONGLONG *pullTimestamp,
out ULONGLONG *pullErrorCode,
out BSTR *pbstrErrorMessage,
out SAFEARRAY(BSTR) *ppsaAdapters,
out BSTR *pbstrAdapterName,
out GUID *pguidTrackingIdOut
);
Parametri
| Parametro | Descrizione |
|---|---|
ulNotificationFlagsIn |
Flag di notifica. Specificare SSO_NOTIFICATION_FLAG_WAIT, se si desidera che la chiamata venga bloccata per l'attesa di una notifica, oppure SSO_NOTIFICATION_FLAG_NONE. |
guidTrackingIdIn |
ID rilevamento. |
pulNnotificationType |
Nell'output restituito è contenuto un puntatore a un ULONG che riceverà il tipo di notifica. |
pulNotificationFlagsOut |
Nell'output restituito è contenuto un puntatore a un ULONG che riceverà i flag di notifica. |
pbstrExternalAccount |
Nell'output restituito è contenuto un account esterno per il quale è necessario modificare la password. |
newExternalPassword |
Nell'output restituito è contenuta la nuova password per l'account esterno. |
pbstrOldExternalPassword |
facoltativo. Nell'output restituito è contenuta la vecchia password per l'account esterno. |
pullTimestamp |
Nell'output restituito è contenuto il timestamp che indica quando è stata eseguita la modifica della password. |
pullErrorCode |
Nell'output restituito è contenuto il codice di errore. |
pbstrErrorMessage |
Nell'output restituito è contenuto un messaggio di errore. |
ppsaAdapters |
Nell'output restituito è contenuta una matrice di nomi di adapter. |
pbstrAdapterName |
Nell'output restituito è contenuto il nome dell'adapter. |
pbuidTrackingIdOut |
Nell'output restituito è contenuto l'ID rilevamento. |
Valore restituito
Questo metodo restituisce un HRESULT che indica se il metodo viene completato in modo corretto. Per ulteriori informazioni, vedere la sezione Eccezioni.
Eccezioni
E_ACCESS_DENIED
Accesso negato.
Commenti
Per restituire informazioni ReceiveNotification utilizza parametri differenti a seconda del parametro notificationType. Nella tabella seguente viene descritta la relazione tra i differenti parametri e tipi di notifica.
| notificationType | Parametri |
|---|---|
| SSO_NOTIFICATION_TYPE_PASSWORD_CHANGE | externalAccount newExternalPassword oldExternalPassword timestamp |
| SSO_NOTIFICATION_TYPE_PASSWORD_CHANGE_COMPLETE | trackingIdIn errorCode errorMessage |
| SSO_NOTIFICATION_TYPE_STATUS_OFFLINE | errorCode errorMessage |
| SSO_NOTIFICATION_TYPE_PASSWORD_EXPIRED | externalAccount |
| SSO_NOTIFICATION_TYPE_STATUS_REQUEST | Nessuno |
| SSO_NOTIFICATION_TYPE_STATUS_ONLINE | Nessuno |