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. |
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
Reference
xxx_IOControl (Services.exe)ServiceAddPort