Fungsi SetServiceBits (lmserver.h)

Artikel
03/14/2023

Mendaftarkan jenis layanan dengan manajer kontrol layanan dan layanan Server. Layanan Server kemudian dapat mengumumkan jenis layanan terdaftar seperti yang saat ini didukungnya. Fungsi NetServerGetInfo dan NetServerEnum mendapatkan jenis layanan yang didukung mesin tertentu.

Sintaks

BOOL NET_API_FUNCTION SetServiceBits(
  [in] SERVICE_STATUS_HANDLE hServiceStatus,
  [in] DWORD                 dwServiceBits,
  [in] BOOL                  bSetBitsOn,
  [in] BOOL                  bUpdateImmediately
);

Parameter

[in] hServiceStatus

Handel ke struktur informasi status untuk layanan. Layanan mendapatkan handel dengan memanggil fungsi RegisterServiceCtrlHandlerEx .

[in] dwServiceBits

Jenis layanan.

Bendera bit tertentu (0xC00F3F7B) dicadangkan untuk digunakan oleh Microsoft. Fungsi SetServiceBits gagal dengan kesalahan ERROR_INVALID_DATA jika salah satu bendera bit ini diatur dalam dwServiceBits. Bendera bit berikut dicadangkan untuk digunakan oleh Microsoft.

SV_TYPE_WORKSTATION (0x00000001)

SV_TYPE_SERVER (0x00000002)

SV_TYPE_DOMAIN_CTRL (0x00000008)

SV_TYPE_DOMAIN_BAKCTRL (0x00000010)

SV_TYPE_TIME_SOURCE (0x00000020)

SV_TYPE_AFP (0x00000040)

SV_TYPE_DOMAIN_MEMBER (0x00000100)

SV_TYPE_PRINTQ_SERVER (0x00000200)

SV_TYPE_DIALIN_SERVER (0x00000400)

SV_TYPE_XENIX_SERVER (0x00000800)

SV_TYPE_SERVER_UNIX (0x00000800)

SV_TYPE_NT (0x00001000)

SV_TYPE_WFW (0x00002000)

SV_TYPE_POTENTIAL_BROWSER (0x00010000)

SV_TYPE_BACKUP_BROWSER (0x00020000)

SV_TYPE_MASTER_BROWSER (0x00040000)

SV_TYPE_DOMAIN_MASTER (0x00080000)

SV_TYPE_LOCAL_LIST_ONLY (0x40000000)

SV_TYPE_DOMAIN_ENUM (0x80000000)

Bendera bit tertentu (0x00300084) ditentukan oleh Microsoft, tetapi tidak secara khusus dicadangkan untuk perangkat lunak sistem. Berikut ini adalah bendera bit ini.

SV_TYPE_SV_TYPE_SQLSERVER (0x00000004)

SV_TYPE_NOVELL (0x00000080)

SV_TYPE_DOMAIN_CTRL (0x00100000)

SV_TYPE_DOMAIN_BAKCTRL (0x00200000)

Bendera bit tertentu (0x3FC0C000) tidak ditentukan oleh Microsoft, dan penggunaannya tidak dikoordinasikan oleh Microsoft. Pengembang aplikasi yang menggunakan bit ini harus menyadari bahwa aplikasi lain juga dapat menggunakannya, sehingga menciptakan konflik. Berikut ini adalah bendera bit ini.

0x00004000

0x00008000

0x00400000

0x00800000

0x01000000

0x02000000

0x04000000

0x08000000

0x10000000

0x20000000

[in] bSetBitsOn

Jika nilai ini TRUE, bit dalam dwServiceBit akan diatur. Jika nilai ini FALSE, bit akan dihapus.

[in] bUpdateImmediately

Jika nilai ini TRUE, layanan Server akan segera melakukan pembaruan. Jika nilai ini FALSE, pembaruan tidak segera dilakukan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	lmserver.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

Netserverenum

NetServerGetInfo

RegisterServiceCtrlHandlerEx

Fungsi Layanan

SetServiceStatus

Share via