Allows the caller to receive service-specific attributes. 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 GetRtServiceAttributes(
    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 where the attributes are to be received.

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 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.

Note:   Other status values may be generated by the service-specific GetAttributes handler.

Requirements

See Also

Port system calls, SERVICEATTRIBUTES, GetAttributes