ISSONotification.SendNotification 方法

从适配器向 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

另请参阅

ISSONotification 接口 (COM)
ISSONotification 成员
使用企业单一登录编程