IOCTL_SERVICE_REGISTER_SOCKADDR
A version of this page is also available for
4/8/2010
This IOCTL is passed as an input parameter along with the sockaddr structure when Services.exe calls the xxx_IOControl (Services.exe) 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
| Header | service.h |
| 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)
ServiceAddPort
Concepts
Registering a Super Service Automatically