ISSONotification.SendNotification 方法

 

從配接器傳送通知 (如密碼變更) 給 ENTSSO 系統。

語法

  
HRESULT SendNotification(  
SSendNotification SendNotification,  
GUID* pguidTrackingId  
);  

參數

SendNotification
[in] 從配接器傳送給 ENTSSO 的通知。

pguidTrackingId
[out] 當這個方法傳回時,會包含 ENTSSO 所產生的追蹤識別碼。 此追蹤識別碼可用於稽核用途,或是用來與要求回應相互關聯。 可能是 NULL。

傳回值

這個方法會傳回 HRESULT,表示它是否正確完成。 如需詳細資訊,請參閱「錯誤值」一節。

錯誤值

這個方法會傳回 HRESULT,其中包含下表的一個值。

描述
S_OK 此方法成功。
E_ACCESSDENIED 存取遭到拒絕。
ENTSSO_E_NO_SERVER 無法連絡 ENTSSO 伺服器。 請檢查 ENTSSO 服務是否正在執行。
ENTSSO_E_WRONG_STATE 已經在錯誤狀態中呼叫這個方法。
ENTSSO_E_INVALID_NOTIFICATION 通知類型無效。

備註

您可以使用 SendNotification 將密碼變更和其他通知傳送至 ENTSSO 系統。

如果 SendNotification 傳回 S_OK,這並不表示已在目的地系統上完成密碼變更。 收到 S_OK 表示 ENTSSO 已接受且終於將要完成您的要求。

來自外部系統的密碼變更可能會產生幾個結果:

  • 如果已設定部分密碼同步,則可能會更新 SSO 資料庫 (如果外部帳戶有目前對應存在的話)。

  • 如果已設定完整密碼同步,則可能也會對 Windows 帳戶進行密碼變更。

如果外部帳戶在 SSO 資料庫中沒有目前的對應,則密碼變更可能不會有任何作用。

從 ENTSSO 的觀點來看,當密碼變更被視為完成時,會發出密碼變更完成的通知,這一點 (如同上面所討論) 可能代表著不同的意義。 在某些情況下,這可能代表未進行任何變更、只有更新 SSO 資料庫,或是已變更 Windows 密碼。

請注意,傳送回到配接器的密碼變更完成通知並不完全可靠。 在某些錯誤的情況下,「單一登入」可能實際上從未收到要求的通知。

在 ENTSSO 中,認證的定義(例如 SendNotification 為了密碼更新所傳送的認證)比簡單密碼更有彈性。 當您定義 SSO 應用程式時,也會定義認證欄位。 這些欄位會識別要用於 UI 欄位的標籤,以及是否要遮罩這些欄位。 此外,也有一個特殊旗標,它會指定該欄位是否應該同步。 欄位0是特殊案例,會定義使用者識別碼的標籤。 如需詳細資訊,請參閱 ISSOAdmin 介面

規格需求

平臺: Windows

另請參閱

ISSONotification 介面 (COM)
ISSONotification 成員
企業單一登入程式設計