ISSONotification.ReceiveNotification 메서드

 

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

참고 항목

ISSONotification 인터페이스(COM)
ISSONotification 멤버
Enterprise Single Sign-On으로 프로그래밍