INapSystemHealthAgentBinding::Initialize 메서드
참고
네트워크 액세스 보호 플랫폼은 Windows 10
INapSystemHealthAgentBinding::Initialize 메서드는 SHA(시스템 상태 에이전트)를 초기화하고 SHA를 NapAgent 서비스에 바인딩합니다. INapSystemHealthAgentBinding2 인터페이스에서 다른 메서드를 호출하기 전에 이 메서드를 호출해야 합니다.
구문
HRESULT Initialize(
[in] SystemHealthEntityId id,
[in] INapSystemHealthAgentCallback *callback
);
매개 변수
-
id [in]
-
NapAgent 서비스에 바인딩되는 SHA의 ID를 포함하는 고유한 SystemHealthEntityId 입니다.
-
콜백 [in]
-
알림/프로세스로 상태 에이전트를 콜백하기 위해 NapAgent에서 사용하는 INapSystemHealthAgentCallback 인터페이스에 대한 COM 포인터입니다. NapAgent는 Uninitialize 가 호출될 때까지 이 인터페이스와 연결된 개체에 대한 참조를 보유합니다.
반환 값
다른 COM 관련 오류 코드도 반환될 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
작업이 성공했습니다. |
|
권한 오류, 액세스가 거부되었습니다. |
|
시스템 리소스 제한, 작업을 수행할 수 없습니다. |
|
SHA가 이전에 초기화된 경우 이 오류가 반환됩니다. |
|
SHA가 이전에 등록되지 않은 경우 이 오류가 반환됩니다. |
|
NapAgent가 중지되었습니다. 이 개체는 자동으로 복구되고 다시 시작되면 NapAgent에 다시 바인딩됩니다. |
설명
NapAgent는 초기화의 결과로 SoH 교환을 트리거하지 않습니다. 시스템 상태 에이전트는 NapAgent를 사용하여 초기화한 후 NotifySoHChange 를 호출하여 SoH 패킷 교환을 요청해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 [데스크톱 앱만 해당] |
| 헤더 |
|
| IDL |
|
| DLL |
|