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

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

NTXSTATUS ntxGetRtServiceAttributes(
    RTHANDLE hPort,
    LPSERVICEATTRIBUTES lpAttributes
);

Parameters

hPort
Handle for the port object connected to the service for whom the attributes are requested.
lpAttributes
Pointer to a SERVICEATTRIBUTES structure where the attributes are received. The length parameter must be specified.

Return Values

E_OK
Success.
The appropriate status code.
Failure. To determine the status, call ntxGetLastRtError.

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 SERVICEATTRIBUTES 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.
E_LOCATION
The RT client on which the port was created is now invalid.
E_NTX_INTERNAL_ERROR
The DLL could not contact the RT kernel to complete the request.
Note:   Other status values may be generated by the service-specific GetAttributes handler.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/nt/include/ntx.h ntx.h ntx.lib
INtime 4.01 (for 64-bit Windows) intime/nt/include/ntx.h ntx.h ntx64.lib

See Also

Port system calls, SERVICEATTRIBUTES, GetAttributes