Funzione SetServiceBits (lmserver.h)
Registra un tipo di servizio con gestione controllo del servizio e il servizio Server. Il servizio Server può quindi annunciare il tipo di servizio registrato come quello attualmente supportato. Le funzioni NetServerGetInfo e NetServerEnum ottengono i tipi di servizio supportati da un computer specificato.
Sintassi
BOOL NET_API_FUNCTION SetServiceBits(
[in] SERVICE_STATUS_HANDLE hServiceStatus,
[in] DWORD dwServiceBits,
[in] BOOL bSetBitsOn,
[in] BOOL bUpdateImmediately
);
Parametri
[in] hServiceStatus
Handle per la struttura delle informazioni sullo stato per il servizio. Un servizio ottiene l'handle chiamando la funzione RegisterServiceCtrlHandlerEx .
[in] dwServiceBits
Tipo di servizio.
Alcuni flag di bit (0xC00F3F7B) sono riservati per l'uso da parte di Microsoft. La funzione SetServiceBits ha esito negativo con l'errore ERROR_INVALID_DATA se uno di questi flag di bit è impostato in dwServiceBits. I flag di bit seguenti sono riservati per l'uso da parte di 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)
Alcuni flag di bit (0x00300084) sono definiti da Microsoft, ma non sono specificamente riservati per il software di sistemi. Di seguito sono riportati questi flag di bit.
SV_TYPE_SV_TYPE_SQLSERVER (0x00000004)
SV_TYPE_NOVELL (0x00000080)
SV_TYPE_DOMAIN_CTRL (0x00100000)
SV_TYPE_DOMAIN_BAKCTRL (0x00200000)
Alcuni flag di bit (0x3FC0C000) non sono definiti da Microsoft e il loro uso non è coordinato da Microsoft. Gli sviluppatori di applicazioni che usano questi bit devono tenere presente che anche altre applicazioni possono usarle, creando così un conflitto. Di seguito sono riportati questi flag di bit.
0x00004000
0x00008000
0x00400000
0x00800000
0x01000000
0x02000000
0x04000000
0x08000000
0x10000000
0x20000000
[in] bSetBitsOn
Se questo valore è TRUE, i bit in dwServiceBit devono essere impostati. Se questo valore è FALSE, i bit devono essere cancellati.
[in] bUpdateImmediately
Se questo valore è TRUE, il servizio server deve eseguire un aggiornamento immediato. Se questo valore è FALSE, l'aggiornamento non viene eseguito immediatamente.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | lmserver.h |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |