Método ISSONotification.ReceiveNotification
Recibe una notificación desde el sistema ENTSSO, por ejemplo cambios de contraseñas.
Sintaxis
HRESULT ReceiveNotification(
ULONG ulNotificationFlagsIn,
SReceiveNotification* pReceiveNotification,
GUID* pguidTrackingId
);
Parámetros
bstrAdapterName
[in] El nombre único del adaptador.
ulNotificationFlagsIn
[in] Las marcas de notificación para controlar esta notificación, desde la enumeración SSO_NOTIFICATION_FLAG.
pReceiveNotification
[in] Puntero a la notificación recibida.
pguidTrackingId
[out] Identificador de seguimiento. El sistema ENTSSO generará un identificador de seguimiento y lo devolverá al autor de la llamada. Este Id. de seguimiento se usa para fines de auditoría y el adaptador también lo puede usar para correlacionar respuestas con solicitudes. Este parámetro puede ser NULO si el adaptador no necesita 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 Valores de error.
Valores de error
Este método devuelve un HRESULT que contiene uno de los valores de la siguiente tabla.
Valor | Descripción |
---|---|
S_OK | Método realizado correctamente. |
E_ACCESSDENIED | Se denegó el acceso. |
ENTSSO_E_NO_SERVER | No se pudo establecer conexión con el servidor ENTSSO. Compruebe que el servicio ENTSSO está en ejecución. |
ENTSSO_E_NO_NOTIFICATIONS | No hay notificaciones para recibir. |
ENTSSO_E_WRONG_STATE | Este método se ha llamado en el estado incorrecto. |
Comentarios
Puede usar ReceiveNotification para recibir los cambios de contraseña y otras notificaciones del sistema ENTSSO.
Puede llamar a ReceiveNotification con o sin una marca WAIT. Si especifica la marca WAIT, ReceiveNotification se bloquea hasta que haya disponible una notificación. Al hacerlo, puede determinar si desea dedicar un subproceso para recibir notificaciones del servicio ENTSSO o si desea usar el identificador de eventos devuelto por InitializeAdapter para realizar sus propias esperas, compartidas con otros eventos.
Si ReceiveNotification está esperando cuando se llama a ShutdownAdapter, ReceiveNotification devuelve una notificación SHUTDOWN como la última notificación. Esta notificación se anticipa a otras notificaciones pendientes.
Es posible que varios subprocesos puedan llamar a ReceiveNotification para el mismo nombre de adaptador. En este caso, la solicitud es de un solo subproceso en el servicio ENTSSO y solo una receiveNotification se completa con información válida. Los subprocesos se completan con la siguiente notificación o con NONE (ninguna). El motivo es que cada uno de estos subprocesos espera el mismo evento.
Requisitos
Plataformas: Windows
Consulte también
Interfaz ISSONotification
Miembros de ISSONotification
Programación con Enterprise Single Sign-On
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de