指示密码同步适配器即将关闭。
语法
HRESULT ShutDownAdapter(
GUID* pguidTrackingId
);
参数
pguidTrackingId
[out]此方法返回时,包含跟踪 ID。 跟踪 ID 与 ENTSSO 在初始化过程中返回的跟踪 ID 相同,可用于审核目的。 可以为 NULL。
返回值
此方法返回一个 HRESULT,指示它是否正确完成。 有关详细信息,请参阅“错误值”部分。
错误值
此方法返回一个 HRESULT,它包含下表中的值之一。
| 值 | 说明 |
|---|---|
| S_OK | 关闭成功。 |
| E_ACCESSDENIED | 访问被拒绝。 |
| ENTSSO_E_NO_SERVER | 无法联系 ENTSSO 服务器。 检查 ENTSSO 服务是否正在运行。 |
| ENTSSO_E_WRONG_STATE | 调用了此方法,但状态有误。 |
注解
ShutdownAdapter 应该是你调用的最后一个方法。 在调用 ShutdownAdapter 后,不能调用 SendNotification 或 ReceiveNotification。之后可以调用的唯一方法是 InitializeAdapter,该方法初始化新会话。
调用 ShutdownAdapter 时,正在其他) 线程上 (对 SendNotification 或 ReceiveNotification 的调用可能会收到ENTSSO_E_WRONG_STATE,但调用 ReceiveNotification 的线程会收到SHUTDOWN_COMPLETE通知。
ShutdownAdapter 是单线程的。 在 ShutdownAdapter 完成之前,ENTSSO 会阻止调用 ShutdownAdapter 的 所有其他线程。 ShutdownAdapter 还与 InitializeAdapter 方法同步。
要求
平台:Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows 11 和 Windows 10