IOCTL_SERVICE_REGISTER_SOCKADDR

  • Article

This IOCTL is passed as an input parameter along with the sockaddr structure when Services.exe calls the xxx_IOControl function to register a service.

Parameters

  • pBufIn
    [in] Pointer to a sockaddr structure specifying the protocol, port, and optionally the address that should be used for listening for a particular service.

Return Values

Returns TRUE if successful, FALSE otherwise. To obtain extended error information, call the SetLastError function.

Remarks

Before Services.exe listens on an incoming socket for a service, it will call the service's xxx_IOControl function with this IOCTL and with the sockaddr as the input parameters. If the service is willing to accept connections on this sockaddr, it will return TRUE. Otherwise, the service will return FALSE and the connection will not be processed.

The very first time Services.exe initializes a super service, it sets the input parameter to NULL to determine whether the service can support super services. The function returns TRUE if the service can support super services, and FALSE if it cannot. Sockets for super services are configured through the registry or a call to the ServiceAddPort function.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Service.h.

See Also

xxx_IOControl | ServiceAddPort | sockaddr | Registering a Super Service Automatically

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.