共用方式為

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