cwbUN_GetSystemNameFromPidl

Purpose

Extracts the iSeries™ system name from a fully-qualified Unity item identifier list.

Syntax

CWBAPI unsigned int WINAPI cwbUN_GetSystemNameFromPidl(
    LPCITEMIDLIST pidl,
    char * szSystemName,
    UINT cchMax
    );

Parameters

LPCITEMIDLIST pidl - input

Pointer to an ITEMIDLIST (item identifier list) structure 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

The specified item identifier list is not valid.

CWB_BUFFER_OVERFLOW

The buffer is too small to contain the returned string.

Usage

None