INtime SDK Help
GetAttributes
INtime Help

GetAttributes

This handler gets attributes from the service when an application calls GetRtServiceAttributes. Implementation is optional, but, if not implemented, the RT kernel returns a status of E_NOT_CONFIGURED when you call GetRtServiceAttributes. If implementation is not required, the pGetAttributes field of the SERVICEDESC structure should be set to NULL.

The SERVICEATTRIBUTES structure returns service-specific parameters and is implementer-defined after the first two fields. Note that values of the wOpCode field in the range 0x8000 to 0xFFFF are handled by the RT kernel and are never passed to the service.

The caller should set the wOpCode and wLength fields before making the call, specifying the function to be performed and the maximum size of the return values.

The implementer must set the return exception code through pExcep before returning. The value returned is passed back to the caller.

void GetAttributes(
    LPSERVICEDESC pService, 
    LPSERVICEATTRIBUTES pAttrib,
    LPWORD pExcep
);

Return Values

Return status code in pExcep.

See Also

RT Service handlers, GetRtServiceAttributes, SERVICEDESC, SERVICEATTRIBUTES