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