从适配器向 ENTSSO 系统发送通知,如密码更改。
语法
HRESULT SendNotification(
SSendNotification SendNotification,
GUID* pguidTrackingId
);
参数
SendNotification
[in] 要从适配器发送到 ENTSSO 的通知。
pguidTrackingId
[out] 此方法返回时,包含 ENTSSO 生成的跟踪 ID。 您可以将跟踪 ID 用于审核目的或用于关联请求响应。 可以为 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 应用程序时,还定义凭据字段。 这些字段标识要用于用户界面字段的标签,以及是否标记这些字段。 此外,还有一个特殊的标记,指定该字段是否应同步。 字段 0 是一种特殊情况,用于定义用户 ID 的标签。 有关详细信息,请参阅 ISSOAdmin 接口。
要求
平台:Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows 11 和 Windows 10