INapSystemHealthAgentBinding::Initialize 方法

注意

從 Windows 10 開始,無法使用網路存取保護平臺

INapSystemHealthAgentBinding::Initialize方法會將系統健康情況代理程式初始化 (SHA) ,並將 SHA 系結至 NapAgent 服務。 在 INapSystemHealthAgentBinding2 介面上呼叫任何其他方法之前,必須先呼叫這個方法。

語法

HRESULT Initialize(
  [in] SystemHealthEntityId          id,
  [in] INapSystemHealthAgentCallback *callback
);

參數

id [in]

唯一 的 SystemHealthEntityId ,其中包含系結至 NapAgent 服務之 SHA 的識別碼。

回呼 [in]

NapAgent 用來以通知/進程回呼健康情況代理程式的 INapSystemHealthAgentCallback 介面的 COM 指標。 NapAgent 會保存與此介面相關聯之物件的參考,直到呼叫 Uninitialize 為止。

傳回值

您也可以傳回其他 COM 特定的錯誤碼。

傳回碼 描述
S_OK
作業成功。
E_ACCESSDENIED
許可權錯誤,拒絕存取。
E_OUTOFMEMORY
系統資源限制,無法執行作業。
ERROR_ALREADY_INITIALIZED
如果先前已初始化 SHA,則會傳回此錯誤。
NAP_E_NOT_REGISTERED
如果 SHA 先前尚未註冊,則會傳回此錯誤。
RPC_E_DISCONNECTED
NapAgent 已停止。 此物件會在重新開機後自動復原並重新系結至 NapAgent。

備註

NapAgent 不會觸發 SoH 交換,因為初始化。 系統健康情況代理程式必須呼叫 NotifySoHChange ,以在使用 NapAgent 初始化之後要求交換 SoH 封包。

規格需求

需求
最低支援的用戶端
Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2008 [僅限傳統型應用程式]
標頭
NapSystemHealthAgent.h
Idl
NapSystemHealthAgent.idl
DLL
Qagent.dll

另請參閱

INapSystemHealthAgentBinding