ServiceAddPort
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função faz com que o Services.exe para escutar no endereço especificado Soquete e as solicitações rede mapa (n.); mapear (v.) o Soquete para a instância serviço especificado.
Syntax
BOOL ServiceAddPort(
HANDLE hService,
SOCKADDR *pSockAddr,
INT cbSockAddr,
INT iProtocol,
WCHAR szRegWritePath
);
Parameters
- hService
[no] Identificador de instância de serviço que o Soquete deve ser associado com.
- pSockAddr
[no] Ponteiro para o endereço rede ao escutar em.
- cbSockAddr
[no] Comprimento de pSockAddr.
- iProtocol
[no] Protocolo da Soquete.
- szRegWritePath
[no] Opcional. Seqüência de caracteres que contém o associado chave do Registro com dado serviço para pSockAddr, cbSockAddr, e iProtocol. Especificando szRegWritePath garantirá que o endereço especificado na função será automaticamente ser escutados em sempre que o servidor inicializa. O serviço deve ter sido iniciado com ActivateService, não RegisterService, para que isso função.
Return Value
Um diferente de zero valor indica sucesso. Um valor de zero indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
Em chamado ServiceAddPort, os valores para pSockAddr, cbSockAddr, e iProtocol Será usado para criar um Soquete e BIND e escutar no endereço especificado.
Quando um solicitação de conexão de entrada leva local, o Services.exe irá chamar aceitar no Soquete e transmiti-lo para o xxx_IOControl (services.exe) exportada do serviço, configuração da função dwCode parâmetro toIOCTL_SERVICE_CONNECTION e passar a Soquete no parâmetro pBufIn.
Super soquetes serviço associado com um determinado serviço pode ser interrompido com um chamar para ServiceUnbindPorts. Eles também serão interrompidos quando o serviço for interrompido durante um chamar para DeregisterService e quando DeviceIoControl Ou ServiceIoControl é chamado especificando o parâmetro IOCTL_SERVICE_STOP.
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
xxx_IOControl (Services.exe)
RegisterService
DeregisterService
ServiceIoControl