INtime SDK Help
LookupPortHandle (deprecated)

From INtime 6.0 the INtime Service and Port objects have been deprecated.

New projects should not be started using these features, and existing projects will not work with XM mode. You will receive a compiler warning by default if you use these calls.

Looks up a port handle given a port ID. For example, when a message has been received at the interface, the service thread needs to know where to deliver the message to in a multiple-port implementation.

RTHANDLE LookupPortHandle(
    LPSERVICEDESC lpServiceDescriptor, 
    WORD wPortID


A pointer to the service descriptor.
The ID of the port whose handle is desired.

Return Values

A valid port handle which can be used in subsequent calls to DeliverMessage or DeliverTransaction.
Failure. To determine the status, call GetLastRtError.


E_CONTEXT 0x0005
The service is being uninstalled.
E_EXIST 0x0006
No port exists with the given ID for this service.
E_TYPE 0x8002
The SERVICEDESC structure is not valid.


Versions Defined in Include Link to
INtime 3.0 intime/rt/include/rtserv.h rtserv.h rtserv.lib

See Also

RT Service system calls, DeliverMessage, DeliverTransaction, SERVICEDESC