Metode INapSystemHealthAgentCallback::GetSoHRequest

Catatan

Platform Perlindungan Akses Jaringan tidak tersedia dimulai dengan Windows 10

Metode INapSystemHealthAgentCallback::GetSoHRequest dipanggil oleh NapAgent untuk mengkueri permintaan SoH agen kesehatan sistem.

Sintaks

HRESULT GetSoHRequest(
  [in] INapSystemHealthAgentRequest *request
);

Parameter

request [in]

Penunjuk COM ke objek INapSystemHealthAgentRequest yang mengidentifikasi objek permintaan.

Mengembalikan nilai

Menampilkan kode	Deskripsi
S_OK	Menunjukkan keberhasilan.
HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)	Jika kode ini dikembalikan oleh implementasi Anda, NapAgent kemudian menghapus SHA dari daftar bound-SHA dan menghapus entri cache-nya.

Ketika nilai pengembalian apa pun (kecuali HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)) dikembalikan oleh implementasi Anda, sistem NAP membangun dan mengembalikan SoHRequest ke SHV terkait dengan jenis dan nilai atribut berikut:

• sohAttributeTypeSystemHealthId= <id>
• sohAttributeTypeFailureCategory= failureCategoryClientComponent
• sohAttributeTypeErrorCodes = <error-code>

Keterangan

Metode panggilan balik ini dideklarasikan oleh sistem NAP dan akan diimplementasikan oleh penulis SHA.

Metode ini harus memproses permintaan dan segera kembali. Menunda pengembalian metode ini berdampak negatif pada performa dan responsivitas sistem, dan dapat menyebabkan bagian lain dari sistem operasi kehabisan waktu.

Pemantauan status kesehatan tidak boleh dilakukan sebagai bagian dari panggilan ini, terutama jika komputasi intensif dan memakan waktu lama. Pemantauan status kesehatan dan komputasi SoH harus dilakukan dalam utas atau layanan terpisah. Satu-satunya fungsi dari metode ini harus mengatur SoH SHA dan mengembalikan.

Jika akan memakan waktu lama bagi SHA untuk menghasilkan SoH, maka SoH yang di-cache harus dikembalikan ke NapAgent. Jika tidak ada SoH yang di-cache untuk dikembalikan, maka SHA harus segera mengembalikan SoH dengan jenis dan nilai atribut berikut:

• sohAttributeTypeSystemHealthId= <id>
• sohAttributeTypeFailureCategory= failureCategoryClientCommunication
• sohAttributeTypeErrorCodes = NAP_E_NO_CACHED_SOH

Ketika SoH telah dibuat, SHA harus memanggil INapSystemHealthAgentBinding::NotifySoHChange untuk memberi tahu NapAgent tentang perubahan kesehatan sistem.

NapAgent memanggil metode ini untuk mengkueri SoHRequest agen kesehatan sistem. SHA dapat mengkueri objek INapSystemHealthAgentRequest yang diteruskan untuk parameter yang diperlukan untuk menghitung SoHRequest. SHA harus mengatur SoHRequest yang dihitung pada objek permintaan. SHA tidak boleh menyimpan referensi ke objek permintaan setelah panggilan ini selesai.

Ketika metode ini dipanggil, jika ada SoH di cache NapAgent, maka metode ini diatur pada objek permintaan. SHA dapat mengkuerinya menggunakan GetSoHRequest. Jika SHA tidak mengatur SoH baru, maka yang di-cache akan digunakan.

Untuk SLA yang tidak terikat yang terdaftar dengan sistem, sistem NAP membangun dan mengirim SoHRequest ke SHV yang sesuai dengan jenis dan nilai atribut berikut:

• sohAttributeTypeSystemHealthId= <id>
• sohAttributeTypeFailureCategory= failureCategoryClientComponent
• sohAttributeTypeErrorCodes = NAP_E_NOT_INITIALIZED

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

Lihat juga

INapSystemHealthAgentCallback