Função SetServiceBits (lmserver.h)
Registra um tipo de serviço com o gerenciador de controle de serviço e o serviço Servidor. Em seguida, o serviço Servidor pode anunciar o tipo de serviço registrado como um compatível no momento. As funções NetServerGetInfo e NetServerEnum obtêm os tipos de serviço com suporte de um computador especificado.
BOOL NET_API_FUNCTION SetServiceBits(
[in] SERVICE_STATUS_HANDLE hServiceStatus,
[in] DWORD dwServiceBits,
[in] BOOL bSetBitsOn,
[in] BOOL bUpdateImmediately
);
[in] hServiceStatus
Um identificador para a estrutura de informações status para o serviço. Um serviço obtém o identificador chamando a função RegisterServiceCtrlHandlerEx .
[in] dwServiceBits
O tipo de serviço.
Determinados sinalizadores de bits (0xC00F3F7B) são reservados para uso pela Microsoft. A função SetServiceBits falhará com o erro ERROR_INVALID_DATA se qualquer um desses sinalizadores de bits estiver definido em dwServiceBits. Os sinalizadores de bit a seguir são reservados para uso pela Microsoft.
Determinados sinalizadores de bits (0x00300084) são definidos pela Microsoft, mas não são especificamente reservados para softwares de sistemas. Veja a seguir esses sinalizadores de bits.
Determinados sinalizadores de bits (0x3FC0C000) não são definidos pela Microsoft e seu uso não é coordenado pela Microsoft. Os desenvolvedores de aplicativos que usam esses bits devem estar cientes de que outros aplicativos também podem usá-los, criando assim um conflito. Veja a seguir esses sinalizadores de bits.
0x00004000
0x00008000
0x00400000
0x00800000
0x01000000
0x02000000
0x04000000
0x08000000
0x10000000
0x20000000
[in] bSetBitsOn
Se esse valor for TRUE, os bits em dwServiceBit deverão ser definidos. Se esse valor for FALSE, os bits deverão ser limpos.
[in] bUpdateImmediately
Se esse valor for TRUE, o serviço Servidor deverá executar uma atualização imediata. Se esse valor for FALSE, a atualização não será executada imediatamente.
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | lmserver.h |
Biblioteca | Advapi32.lib |
DLL | Advapi32.dll |