암호 변경과 같은 ENTSSO 시스템에서 알림을 받습니다.
문법
HRESULT ReceiveNotification(
ULONG ulNotificationFlagsIn,
SReceiveNotification* pReceiveNotification,
GUID* pguidTrackingId
);
매개 변수
bstrAdapterName
[in] 고유한 어댑터 이름입니다.
ulNotificationFlagsIn
[in] SSO_NOTIFICATION_FLAG 열거형에서 이 알림을 제어하는 알림 플래그입니다.
pReceiveNotification
[in] 받은 알림에 대한 포인터입니다.
pguidTrackingId
[out] 추적 ID입니다. ENTSSO 시스템은 추적 ID를 생성하고 호출자에게 반환합니다. 추적 ID는 감사 목적으로 사용되며 어댑터에서 요청에 대한 응답의 상관 관계를 지정하는 데 사용할 수도 있습니다. 어댑터에서 추적 ID가 필요하지 않은 경우 이 매개 변수는 NULL일 수 있습니다.
반환 값
이 메서드는 올바르게 완료되었는지 여부를 나타내는 HRESULT를 반환합니다. 자세한 내용은 오류 값 섹션을 참조하세요.
오류 값
이 메서드는 다음 표의 값 중 하나를 포함하는 HRESULT를 반환합니다.
| 가치 | 설명 |
|---|---|
| S_OK | 메서드가 성공했습니다. |
| E_ACCESSDENIED | 액세스가 거부되었습니다. |
| ENTSSO_E_NO_SERVER | ENTSSO 서버에 연결할 수 없습니다. ENTSSO 서비스가 실행 중인지 확인합니다. |
| ENTSSO_E_NO_NOTIFICATIONS | 받을 알림이 없습니다. |
| ENTSSO_E_WRONG_STATE | 이 메서드가 잘못된 상태에서 호출되었습니다. |
비고
ReceiveNotification을 사용하여 ENTSSO 시스템에서 암호 변경 내용 및 기타 알림을 모두 받을 수 있습니다.
WAIT 플래그를 사용하거나 사용하지 않고 ReceiveNotification 을 호출할 수 있습니다. WAIT 플래그를 지정하면 알림을 사용할 수 있게 될 때까지 ReceiveNotification 이 차단됩니다. 이렇게 하면 ENTSSO 서비스에서 알림을 받기 위해 스레드를 전용으로 사용할지 또는 InitializeAdapter 에서 반환된 이벤트 핸들을 사용하여 다른 이벤트와 공유된 자체 대기를 수행할지 여부를 결정할 수 있습니다.
ShutdownAdapter를 호출할 때 ReceiveNotification이 대기 중인 경우 ReceiveNotification은 SHUTDOWN 알림을 마지막 알림으로 반환합니다. SHUTDOWN 알림은 다른 보류 중인 알림을 선점합니다.
여러 스레드가 동일한 어댑터 이름으로 ReceiveNotification 을 호출할 수 있습니다. 이 경우 요청은 ENTSSO 서비스에서 단일 스레드되고 하나의 ReceiveNotification 만 유효한 정보로 완료됩니다. 스레드는 다음 알림 또는 NONE으로 완료됩니다. 그 이유는 이러한 각 스레드가 동일한 이벤트를 대기하기 때문입니다.
요구 사항
플랫폼: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 및 Windows 10
또한 참조하십시오
ISSONotification 인터페이스(COM)
ISSONotification 멤버
Enterprise Single Sign-On을 사용한 프로그래밍