PxMcGetName()

Return the name of an mc object.

APPLIES TO

1.0.0

SYNOPSIS
PxError_t PxMcGetName (PxMc_t mc, PxChar_t *buffer, PxUInt_t bufsize);
ARGUMENTS
mc

The mc object id

buffer

Data area to copy the mc object name to.

bufsize

The length of the mc object name.

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

ERROR CODES

PXERR_NAME_BUFOVERFLOW

The data area is too short to store the objects name

PXERR_OBJ_ILLOBJ

mc is not a valid object id

PXERR_PROT_PERMISSION

The data area is not writeable for the calling task

PXERR_GLOBAL_ILLEGAL_CORE

The requested object is not on the same core

PXERR_SERVICE_NOT_CONFIGURED

Service has not been configured

DESCRIPTION

PxMcGetName copies the name of mc into the buffer buffer of length bufsize. The result is zero-terminated.