PxMbxSetName()

Assign a name to an mailbox (Mbx) object.

APPLIES TO

8.2.0

SYNOPSIS
PxError_t PxMbxSetName (PxMbx_t mbx, const PxChar_t *buffer, PxUInt_t bufsize);
ARGUMENTS






mbx




The mailbox (mbx) id.


















buffer




Data area used to copy the mailbox (Mbx) object name from.


















bufsize




The length of the mailbox (Mbx) object name.

















RETURN VALUES






    

  • 

    PXERR_NOERROR if successful, or a PXROS-HR error code otherwise.
    

    • 







ERROR CODES















PXERR_GLOBAL_ILLEGAL_CORE




The requested object is not on the same core








PXERR_NAME_BUFOVERFLOW




The name has been truncated








PXERR_OBJ_ILLOBJ




The passed object handle is not valid








PXERR_PROT_PERMISSION




The name is not readable for the calling task








PXERR_SERVICE_NOT_CONFIGURED




Service has not been configured








PXERR_ILLEGAL_ACCESS




Access through parameter pointer in size is illegal









DESCRIPTION










PxMbxSetName assigns the name to the object with handle mbx.



























SEE ALSO