ISSOWrapper.ReceiveNotification メソッド
アダプターへの通知を ENTSSO サービスから受信します。
構文
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
);
パラメーター
| パラメーター | 説明 |
|---|---|
ulNotificationFlagsIn |
通知フラグ。 呼び出しによって通知の待機をブロックする場合は SSO_NOTIFICATION_FLAG_WAIT を指定します。それ以外の場合は SSO_NOTIFICATION_FLAG_NONE を指定します。 |
guidTrackingIdIn |
追跡 ID。 |
pulNnotificationType |
戻るときには、通知の種類を受信する ULONG へのポインターが格納されています。 |
pulNotificationFlagsOut |
戻るときには、通知フラグを受信する ULONG へのポインターが格納されています。 |
pbstrExternalAccount |
戻るときには、パスワードを変更する必要がある外部アカウントが格納されています。 |
newExternalPassword |
戻るときには、外部アカウントの新しいパスワードが格納されています。 |
pbstrOldExternalPassword |
省略可能。 戻るときには、外部アカウントの古いパスワードが格納されています。 |
pullTimestamp |
戻るときには、パスワードの変更が行われたときのタイムスタンプが格納されています。 |
pullErrorCode |
戻るときには、エラー コードが格納されています。 |
pbstrErrorMessage |
戻るときには、エラー メッセージが格納されています。 |
ppsaAdapters |
戻るときには、アダプターの名前の配列が格納されています。 |
pbstrAdapterName |
戻るときには、アダプター名が格納されています。 |
pbuidTrackingIdOut |
戻るときには、追跡 ID が格納されています。 |
戻り値
このメソッドは、正しく終了したかどうかを示す HRESULT を返します。 詳細については、「例外」を参照してください。
例外
E_ACCESS_DENIED
アクセスが拒否されました。
注釈
ReceiveNotification は、notificationType に応じて異なるパラメーターを使用して情報を返します。 次の表に、さまざまなパラメーターと通知の種類の関係を示します。
| notificationType | パラメーター |
|---|---|
| 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 | なし |
| SSO_NOTIFICATION_TYPE_STATUS_ONLINE | なし |