Voltar à lista
Windows Win32Serviçosadvapi32.dll

OpenSCManagerW

Abre uma conexão com o Service Control Manager (SCM), o gerenciador central de serviços do Windows.

Descrição

Passo inicial obrigatório antes de criar, consultar ou controlar qualquer serviço — o SCM é o análogo Windows mais próximo do systemd/init como supervisor de daemons de longa duração, mas nativo do sistema operacional desde o início.

Header: winsvc.hDLL: advapi32.dll

Assinatura

SC_HANDLE OpenSCManagerW(
    LPCWSTR lpMachineName,
    LPCWSTR lpDatabaseName,
    DWORD dwDesiredAccess
);

Parâmetros

ParâmetroTipoDescrição
lpMachineNameLPCWSTRNome da máquina remota, ou NULL para a local.
lpDatabaseNameLPCWSTRNome do banco de dados de serviços, ou NULL para o padrão (SERVICES_ACTIVE_DATABASE).
dwDesiredAccessDWORDSC_MANAGER_CONNECT, SC_MANAGER_CREATE_SERVICE, SC_MANAGER_ALL_ACCESS, etc.

Valor de retorno

Um handle para o SCM em sucesso; NULL em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_ACCESS_DENIED(5)
Acesso negado.

Relacionadas

Mesma categoria

ChangeServiceConfigWCloseServiceHandleControlServiceCreateServiceWDeleteServiceEnumServicesStatusExWOpenServiceWQueryServiceStatus