Método ISSONotification.ReceiveNotification

  • Artículo

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 VALOR 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 Acceso denegado.
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 una notificación disponible. Esto le permite determinar si desea dedicar un subproceso para recibir notificaciones del servicio ENTSSO o si desea usar el identificador de eventos devuelto de InitializeAdapter para realizar sus propias esperas, compartidas con otros eventos.

Si ReceiveNotification está esperando al llamar 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 se realiza en un único subproceso en el servicio ENTSSO y solo se completa una receiveNotification 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 Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 y Windows 10

Consulte también

Interfaz ISSONotification
Miembros de ISSONotification
Programación con Enterprise Single Sign-On