INtime SDK Help
SetRtServiceAttributes
INtime SDK v6 > About INtime > INtime Kernel > Ports > SetRtServiceAttributes

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.

Allows the caller to specify service-specific parameters. The parameters are service-specific, and multiple parameter sets may be supported by the service, switched by the wOpCode field of the SERVICEATTRIBUTES structure.

BOOLEAN SetServiceAttributes(
    RTHANDLE hPort, 
    LPSERVICEATTRIBUTES lpAttributes
);

Parameters

hPort
Handle for the port object connected to the service for whom the local address is requested.
lpAttributes
Pointer to a SERVICEATTRIBUTES structure containing the service parameters.

Return Values

TRUE
Success.
FALSE
Failure. To determine the status, call GetLastRtError.

Status

E_OK 0x0000
No exceptional conditions occurred.
E_EXIST 0x0006
The port is being deleted.
E_NOT_CONFIGURED 0x0008
The service has not supplied a GetAttributes handler.
E_PARAM 0x8004
The wOpCode field in the SERVICEATTRIBUTE structure contains an invalid value.
Insufficient buffer length has been supplied to satisfy the request.
E_TYPE 0x8002
The handle supplied is not the handle for a port.
E_NUC_BAD_BUF 0x80e2
An invalid attributes pointer was supplied.
Note:   Other status values may be generated by the service-specific SetAttributes handler.

Requirements

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

See Also

Port system calls, SERVICEATTRIBUTES, SetAttributes