Metode INetFwServiceRestriction::RestrictService (netfw.h)

Metode RestrictService mengaktifkan atau menonaktifkan pembatasan layanan untuk layanan tertentu.

Sintaks

HRESULT RestrictService(
  [in] BSTR         serviceName,
  [in] BSTR         appName,
  [in] VARIANT_BOOL restrictService,
  [in] VARIANT_BOOL serviceSidRestricted
);

Parameter

[in] serviceName

Nama layanan tempat pembatasan layanan diaktifkan atau dinonaktifkan.

[in] appName

Nama aplikasi yang pembatasan layanannya sedang diaktifkan atau dinonaktifkan.

[in] restrictService

Menunjukkan apakah pembatasan layanan diaktifkan atau dinonaktifkan. Jika nilai ini benar (VARIANT_TRUE), layanan akan dibatasi saat mengirim atau menerima lalu lintas jaringan. Kumpulan aturan Pengerasan Layanan Windows dapat berisi aturan yang dapat memungkinkan layanan ini khusus akses jaringan masuk atau keluar per persyaratan tertentu. Jika false (VARIANT_FALSE), layanan tidak dibatasi oleh Pengerasan Layanan Windows.

[in] serviceSidRestricted

Menunjukkan jenis SID layanan untuk layanan yang ditentukan. Jika nilai ini benar (VARIANT_TRUE), SID layanan akan dibatasi. Jika tidak, itu tidak akan dibatasi.

Nilai kembali

C++

Jika metode berhasil, nilai yang dikembalikan adalah S_OK.

Jika metode gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
E_ACCESSDENIED	Operasi dibatalkan karena masalah izin.
E_INVALIDARG	Metode gagal karena parameter yang tidak valid.

 

VB

Jika metode berhasil, nilai yang dikembalikan adalah S_OK.

Jika metode gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
E_ACCESSDENIED	Operasi dibatalkan karena masalah izin.
E_INVALIDARG	Metode gagal karena parameter yang tidak valid.

Keterangan

Saat menambahkan aturan, perhatikan bahwa mungkin ada jeda waktu kecil sebelum aturan yang baru ditambahkan diterapkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	netfw.h
DLL	FirewallAPI.dll

Lihat juga

INetFwServiceRestriction