GetServiceHandle

9/8/2008

Essa função retorna o identificador para uma instância serviço baseada no seu prefixo.

Essa função é substituído. Para obter um identificador serviço, chamar CreateFile com o mesmo prefixo do serviço cujo identificador deve ser recuperada.

Observação

Não uso CreateFile Para o identificador serviço get se DeregisterService é chamado para descarregar o serviço especificado.Neste maiúsculas e minúsculas, chamar GetServiceHandle Para obter o identificador.

Syntax

HANDLE GetServiceHandle(
  LPWSTR szPrefix,
  LPWSTR szDllName,
  DWORD pdwDllBuf
);

Parameters

• szPrefix
  [no] Seqüência de caracteres que especifica o prefixo do serviço cujo identificador deve ser recuperada. Esta seqüência de caracteres Consta a forma XXXN:, onde XXX o prefixo for especificado em um RegisterService ou o valor do Registro de prefixo ler durante ActivateService, e N é a número de índice. De exemplo, o prefixo HTP0: Especifica a servidor Web.

• szDllName
  [out] Opcional. Seqüência de caracteres que contém o nome do associado DLL serviço com szPrefix.

• pdwDllBuf
  [in, Out] Opcional. Ponteiro para o DWORD que especifica o número de bytes na szDllName reserva. Em retorno, especifica o número de bytes gravados ou o número de bytes exigido se a reserva não for grande o suficiente. Esse valor inclui o encerrando NULL caractere.

Return Value

Retorna um identificador para o serviço solicitado em caso de sucesso e INVALID_HANDLE_VALUE em falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Essa função retorna o identificador para uma instância serviço baseada no seu prefixo. Essa função é substituído. Para obter um identificador serviço, chamar CreateFile com o mesmo prefixo do serviço cujo identificador deve ser recuperada.

Requirements

Header	service.h
Library	coredll.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

RegisterService
ActivateService

Other Resources

Services.exe
CreateFile