Método ISSOWrapper.ReceiveNotification
Recibe una notificación al adaptador desde el servicio ENTSSO.
Sintaxis
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
);
Parámetros
Parámetro | Descripción |
---|---|
ulNotificationFlagsIn |
Las marcas de notificación. Especifique SSO_NOTIFICATION_FLAG_WAIT si desea que su llamada se bloquee en espera de una notificación, o bien SSO_NOTIFICATION_FLAG_NONE. |
guidTrackingIdIn |
El Id. de seguimiento. |
pulNnotificationType |
Una vez devuelta, contiene un puntero que remite a un ULONG que recibirá el tipo de notificación. |
pulNotificationFlagsOut |
Una vez devuelta, contiene un puntero que remite a un ULONG que recibirá las marcas de notificación. |
pbstrExternalAccount |
Una vez devuelta, contiene la cuenta externa para la que debe cambiarse la contraseña. |
newExternalPassword |
Una vez devuelta, contiene la nueva contraseña de la cuenta externa. |
pbstrOldExternalPassword |
Opcional. Una vez devuelta, contiene la contraseña antigua de la cuenta externa. |
pullTimestamp |
Una vez devuelta, contiene la marca de hora que indica el momento en que se cambió la contraseña. |
pullErrorCode |
Una vez devuelta, contiene el código de error. |
pbstrErrorMessage |
Una vez devuelta, contiene un mensaje de error. |
ppsaAdapters |
Una vez devuelta, contiene una matriz de nombres de adaptador. |
pbstrAdapterName |
Una vez devuelta, contiene el nombre del adaptador. |
pbuidTrackingIdOut |
Una vez devuelta, contiene el Id. de seguimiento. |
Valor devuelto
Este método devuelve un HRESULT que indica si se completó correctamente. Para obtener más información, consulte la sección Excepciones.
Excepciones
E_ACCESS_DENIED
Acceso denegado.
Comentarios
ReceiveNotification usa parámetros distintos para devolver información según el notificationType. En la siguiente tabla se describe la relación entre los distintos parámetros y tipos de notificaciones.
notificationType | Parámetros |
---|---|
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 | None |
SSO_NOTIFICATION_TYPE_STATUS_ONLINE | None |