Metode INapSystemHealthAgentBinding::Initialize

Catatan

Platform Perlindungan Akses Jaringan tidak tersedia dimulai dengan Windows 10

Metode INapSystemHealthAgentBinding::Initialize menginisialisasi agen kesehatan sistem (SHA) dan mengikat SHA ke layanan NapAgent. Metode ini harus dipanggil sebelum memanggil metode lain pada antarmuka INapSystemHealthAgentBinding2 .

Sintaks

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

Parameter

id [in]

SystemHealthEntityId unik yang berisi ID SHA yang terikat ke layanan NapAgent.

callback [in]

Penunjuk COM ke antarmuka INapSystemHealthAgentCallback yang digunakan oleh NapAgent untuk memanggil balik agen kesehatan dengan pemberitahuan/proses. NapAgent menyimpan referensi ke objek yang terkait dengan antarmuka ini hingga Batalkan inisialisasi dipanggil.

Nilai kembali

Kode kesalahan khusus COM lainnya juga dapat dikembalikan.

Menampilkan kode Deskripsi
S_OK
Operasi berhasil.
E_ACCESSDENIED
Kesalahan izin, akses ditolak.
E_OUTOFMEMORY
Batas sumber daya sistem, tidak dapat melakukan operasi.
ERROR_ALREADY_INITIALIZED
Jika SHA telah diinisialisasi sebelumnya, kesalahan ini dikembalikan.
NAP_E_NOT_REGISTERED
Jika SHA belum mendaftar sebelumnya, kesalahan ini dikembalikan.
RPC_E_DISCONNECTED
NapAgent telah dihentikan. Objek ini akan pulih secara otomatis dan terikat kembali ke NapAgent, setelah dimulai ulang.

Keterangan

NapAgent tidak memicu pertukaran SoH sebagai akibat dari inisialisasi. Agen kesehatan sistem harus memanggil NotifySoHChange untuk meminta pertukaran paket SoH setelah menginisialisasi dengan NapAgent.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung
Windows Server 2008 [hanya aplikasi desktop]
Header
NapSystemHealthAgent.h
IDL
NapSystemHealthAgent.idl
DLL
Qagent.dll

Lihat juga

INapSystemHealthAgentBinding