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 Server 2022、Windows Server 2019、Windows Server 2016、Windows 11和Windows 10