cwbUN_GetSystemNameFromName

Purpose

Extracts the iSeries™ system name from a fully-qualified Unity object name.

Syntax

CWBAPI unsigned int WINAPI cwbUN_GetSystemNameFromName(
    const char * szObjectName,
    char * szSystemName,
    UINT cchMax
    );

Parameters

const char * szObjectName - input

The Unity object name from which the system name will be extracted.

char * szSystemName - output

Address of the buffer that will receive the null-terminated system name.

UINT cchMax - input

Size of the buffer that will receive the null-terminated system name.

Return Codes

The following list shows common return values:

CWB_OK

Successful completion.

CWBUN_FORMAT_NOT_VALID

Specified object name is not valid.

CWB_BUFFER_OVERFLOW

The buffer is too small to contain the returned string.

Usage

None