The SetServiceBits function registers a service type with the service control manager and the Server service. The Server service can then announce the registered service type as one it currently supports. The NetServerGetInfo and NetServerEnum functions obtain a specified machine's supported service types.
A service type is represented as a set of bit flags; the SetServiceBits function sets or clears combinations of those bit flags.
BOOL SetServiceBits(
SERVICE_STATUS_HANDLE hServiceStatus,
// service status handle
DWORD dwServiceBits,
// service type bits to set or clear
BOOL bSetBitsOn, // flag to set or clear the service type bits
BOOL bUpdateImmediately
// flag to announce server type immediately
);
Certain bit flags (0xC00F3F7B) are reserved for use by Microsoft. The SetServiceBits function fails with the error ERROR_INVALID_DATA if any of these bit flags are set in dwServiceBits. The following 18 bit flags are reserved for use by Microsoft:
Reserved Bit Flag | Value |
---|---|
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 |
Certain bit flags (0x00300084) are defined by Microsoft, but are not specifically reserved for systems software. The following are these four bit flags:
Bit Flag Constant | Value |
---|---|
SV_TYPE_SV_TYPE_SQLSERVER | 0x00000004 |
SV_TYPE_NOVELL | 0x00000080 |
SV_TYPE_DOMAIN_CTRL | 0x00100000 |
SV_TYPE_DOMAIN_BAKCTRL | 0x00200000 |
Certain bit flags (0x3FC0C000) are not defined by Microsoft, and their use is not coordinated by Microsoft. Developers of applications that use these bits should be aware that other applications can also use them, thus creating a conflict. The following are these 10 bit flags:
Value | Value |
---|---|
0x00004000 | 0x02000000 |
0x00008000 | 0x04000000 |
0x00400000 | 0x08000000 |
0x00800000 | 0x10000000 |
0x01000000 | 0x20000000 |
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Windows NT: Requires version 3.5 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in lmserver.h.
Import Library: Use advapi32.lib.
Services Overview, Service Functions, NetServerGetInfo, NetServerEnum, RegisterServiceCtrlHandler, SetServiceStatus