CMPIString Support

Functions
static const char *	CMGetCharPtr (const CMPIString *str)
	Get the C-language string representation of a CMPIString object (Deprecated). More...
static const char *	CMGetCharsPtr (const CMPIString *str, CMPIStatus *rc)
	Get a C-language string representation of a CMPIString object. More...
static char *	CMNewCharsCP (const CMPIString *str, const CMPICodepageID cpid, CMPIStatus *rc)
	Create a C-language string that has converted a CMPIString object into a specific codepage. More...

Detailed Description

Function Documentation

static const char* CMGetCharPtr ( const CMPIString *  str )

inlinestatic

Get the C-language string representation of a CMPIString object (Deprecated).

Parameters

str	CMPIString object.

Returns

C-language string representation of the CMPIString object.

Full Description

CMPIStringFT.getCharPtr()

Examples

 (.c)
myObjPath = CMNewObjectPath(
    _broker,
    CMGetCharPtr(CMGetNameSpace(ref,0)),
    "TestCMPI_KeyReturned",
    0);

Deprecated:

This macro is deprecated since CMPI 2.1, because it does not provide argument checking or a return code. Use CMGetCharsPtr(), instead.

See Also

CMGetCharsPtr()

Status for OpenPegasus:

TBD

static const char* CMGetCharsPtr ( const CMPIString *  str, CMPIStatus *  rc  )

inlinestatic

Get a C-language string representation of a CMPIString object.

Parameters

	str	CMPIString object.
[out]	rc	Function return status (suppressed when NULL).

Returns

C-language string representation of the CMPIString object.

Full Description

CMPIStringFT.getCharPtr()

Examples

 (.c)
CMPIObjectPath *op = NULL;
CMPIStatus rc = { CMPI_RC_OK, NULL };
objPath = CMNewObjectPath (_broker,
    CMGetCharsPtr(CMGetNameSpace(ref, &rc), NULL),
    class,
    &rc);

Status for OpenPegasus:

TBD

static char* CMNewCharsCP ( const CMPIString *  str, const CMPICodepageID  cpid, CMPIStatus *  rc  )

inlinestatic

Create a C-language string that has converted a CMPIString object into a specific codepage.

Parameters

	str	CMPIString object.
	cpid	CMPI-specific codepage ID for the codepage to convert to. See CMPICodepageID for a list of supported codepages and their codepage ID values.
[out]	rc	Function return status (suppressed when NULL).

Returns

A new C-language string will be returned, in the codepage specified in cpid.

Full Description

CMPIStringFT.newCharsCP()

Examples

 (.c)
CMPIString *str; // set up elsewhere
char *chars;
CMPIStatus rc = { CMPI_RC_OK, NULL };
chars = CMNewCharsCP(str, CMPI_CPID_SYSTEM, &rc);

Addition:

Added in CMPI 2.1.

Status for OpenPegasus:

TBD