Voltar à lista
Windows Win32Serviçosadvapi32.dll

ChangeServiceConfigW

Altera a configuração de um serviço já registrado (tipo de início, executável, conta, etc.).

Descrição

Contraparte de reconfiguração de CreateServiceW para um serviço existente.

Header: winsvc.hDLL: advapi32.dll

Assinatura

BOOL ChangeServiceConfigW(
    SC_HANDLE hService,
    DWORD dwServiceType,
    DWORD dwStartType,
    DWORD dwErrorControl,
    LPCWSTR lpBinaryPathName,
    LPCWSTR lpLoadOrderGroup,
    LPDWORD lpdwTagId,
    LPCWSTR lpDependencies,
    LPCWSTR lpServiceStartName,
    LPCWSTR lpPassword,
    LPCWSTR lpDisplayName
);

Parâmetros

ParâmetroTipoDescrição
hServiceSC_HANDLEHandle do serviço, aberto com SERVICE_CHANGE_CONFIG.
dwServiceTypeDWORDNovo tipo, ou SERVICE_NO_CHANGE.
dwStartTypeDWORDNovo tipo de início, ou SERVICE_NO_CHANGE.
dwErrorControlDWORDNovo controle de erro, ou SERVICE_NO_CHANGE.
lpBinaryPathNameLPCWSTRNovo caminho do executável, ou NULL.
lpLoadOrderGroupLPCWSTRNovo grupo de ordem, ou NULL.
lpdwTagIdLPDWORDRecebe a nova tag, se solicitado.
lpDependenciesLPCWSTRNova lista de dependências, ou NULL.
lpServiceStartNameLPCWSTRNova conta de execução, ou NULL.
lpPasswordLPCWSTRNova senha, se aplicável.
lpDisplayNameLPCWSTRNovo nome exibido, ou NULL.

Valor de retorno

Diferente de zero em sucesso; 0 em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_ACCESS_DENIED(5)
Acesso negado.
ERROR_INVALID_PARAMETER(87)
Parâmetro incorreto.

Relacionadas