Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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

Parameters

pBufIn

[in] Pointer to a sockaddrstructure 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 SetLastErrorfunction.

Remarks

Before Services.exe listens on an incoming socket for a service, it will call the service's xxx_IOControlfunction with this IOCTL and with the sockaddras 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 ServiceAddPortfunction.

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