Purpose
Set the name of the library for this program
object.
Syntax
unsigned int CWB_ENTRY cwbRC_SetLibName(
cwbRC_PgmHandle program,
const char *libraryName);
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 *libraryName - input
- Pointer to an ASCIIZ string that contains the name of the library where
the program resides.
Return Codes
The following list shows common return
values.
- CWB_OK
- Successful completion.
- CWBRC_INVALID_PROGRAM
- Invalid program handle.
- CWBRC_LIBRARY_NAME
- Library 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 name of the library that contains the program you want to call.
This function should not be used to call a different program with different
parameters.