Método INapSystemHealthAgentBinding::Initialize

Artículo
06/13/2023

Nota

La plataforma protección de acceso a redes no está disponible a partir de Windows 10

El método INapSystemHealthAgentBinding::Initialize inicializa el agente de mantenimiento del sistema (SHA) y enlaza el SHA al servicio NapAgent. Se debe llamar a este método antes de llamar a cualquier otro método en la interfaz INapSystemHealthAgentBinding2 .

Sintaxis

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

Parámetros

id [in]: SystemHealthEntityId único que contiene el identificador del SHA que se enlaza al servicio NapAgent.
devolución de llamada [in]: Puntero COM a una interfaz INapSystemHealthAgentCallback usada por NapAgent para realizar una devolución de llamada al agente de mantenimiento con una notificación o proceso. NapAgent contiene una referencia al objeto asociado a esta interfaz hasta que se llama a Uninitialize .

Valor devuelto

También se pueden devolver otros códigos de error específicos de COM.

Código devuelto	Descripción
S_OK	Operación realizada correctamente.
E_ACCESSDENIED	Error de permisos, acceso denegado.
E_OUTOFMEMORY	El límite de recursos del sistema no pudo realizar la operación.
ERROR_ALREADY_INITIALIZED	Si el SHA se ha inicializado anteriormente, se devuelve este error.
NAP_E_NOT_REGISTERED	Si el SHA no se ha registrado anteriormente, se devuelve este error.
RPC_E_DISCONNECTED	NapAgent se ha detenido. Este objeto se recuperará automáticamente y se volverá a enlazar a NapAgent, una vez que se reinicie.

Observaciones

NapAgent no desencadena un intercambio soH como resultado de la inicialización. Un agente de mantenimiento del sistema debe llamar a NotifySoHChange para solicitar un intercambio de paquetes SoH después de inicializar con NapAgent.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	NapSystemHealthAgent.h
IDL	NapSystemHealthAgent.idl
Archivo DLL	Qagent.dll

Vea también

INapSystemHealthAgentBinding