Função OpenServiceA (winsvc.h)
Abre um serviço existente.
Sintaxe
SC_HANDLE OpenServiceA(
[in] SC_HANDLE hSCManager,
[in] LPCSTR lpServiceName,
[in] DWORD dwDesiredAccess
);
Parâmetros
[in] hSCManager
Um identificador para o banco de dados do gerenciador de controle de serviço. A função
[in] lpServiceName
O nome do serviço a ser aberto. Esse é o nome especificado pelo parâmetro lpServiceName da função CreateService quando o objeto de serviço foi criado, não o nome de exibição de serviço mostrado por aplicativos de interface do usuário para identificar o serviço.
O comprimento máximo da cadeia de caracteres é de 256 caracteres. O banco de dados do gerenciador de controle de serviço preserva o caso dos caracteres, mas as comparações de nome de serviço sempre diferenciam maiúsculas de minúsculas. Barra de encaminhamento (/) e barra invertida (\) são caracteres de nome de serviço inválidos.
[in] dwDesiredAccess
O acesso ao serviço. Para obter uma lista de direitos de acesso, consulte Segurança do Serviço e Direitos de Acesso.
Antes de conceder o acesso solicitado, o sistema verifica o token de acesso do processo de chamada na lista de controle de acesso discricionário do descritor de segurança associado ao objeto de serviço.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será um identificador para o serviço.
Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.
Os códigos de erro a seguir podem ser definidos pelo gerenciador de controle de serviço. Outras podem ser definidas pelas funções do Registro que são chamadas pelo gerenciador de controle de serviço.
| Código de retorno | Descrição |
|---|---|
|
O identificador não tem acesso ao serviço. |
|
O identificador especificado é inválido. |
|
O nome do serviço especificado é inválido. |
|
O serviço especificado não existe. |
Observações
O identificador retornado só é válido para o processo chamado OpenService. Ele pode ser fechado chamando a função CloseServiceHandle.
Para usar OpenService, nenhum privilégio é necessário além de SC_MANAGER_CONNECT.
Exemplos
Para obter um exemplo, consulte Iniciando um serviço.
Nota
O cabeçalho winsvc.h define OpenService como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winsvc.h (incluir Windows.h) |
| biblioteca | Advapi32.lib |
| de DLL |
Advapi32.dll |
Consulte também
EnumDependentServices