cwbRC_SetPgmName

Purpose

Set the name of the program for this program object.

Syntax

 
unsigned int CWB_ENTRY cwbRC_SetPgmName(
                             cwbRC_PgmHandle     program,
                             const char         *programName);

Parameters

cwbRC_PgmHandle program - input

Handle that was returned by a previous call to the cwbRC_CreatePgm API. It identifies the program object.

const char *programName - input

Pointer to an ASCIIZ string that contains the name of the program that you want to call.

Return Codes

The following list shows common return values.

CWB_OK

Successful completion.

CWBRC_INVALID_PROGRAM

Invalid program handle.

CWBRC_PROGRAM_NAME

Program name is too long.

CWB_NOT_ENOUGH_MEMORY

Insufficient memory; may have failed to allocate temporary buffer.

CWB_NON_REPRESENTABLE_UNICODE_CHAR

One or more input Unicode characters have no representation in the codepage being used.

CWB_API_ERROR

General API failure.

Usage

Use this function to change the name of the program that you want to call. This function should not be used to change the program object to call a different program with different parameters.