NBBSAUpdateEnv
Update the current environment for the session.
SYNOPSIS
#include <nbbsa.h>
int NBBSAUpdateEnv(BSA_Handle *bsaHandle, char **envPtr)
DESCRIPTION
NBBSAUpdateEnv() resets the environment pairs in the current environment. It performs the same functionality as NBBSASetEnv() except it takes a string of multiple (keyword, value) pairs. The same restrictions apply to updating some of the restricted variables. If a variable exists in the environment but is not included in the list being updated, it remains in the environment.
The XBSA specifications do not provide a way for these XBSA environment variables to be reset after the session has been initiated with BSAInit().
PARAMETERS
BSA_Handle bsaHandle (I) | The handle that associates this call with a previous BSAInit() call. |
char **envPtr (I) | Pointer to a structure that contains the new environment variables (keyword, value) pairs, for the session. The environment consists of a pointer to an array of strings. |
RETURN VALUE
The following return codes are returned by this function:
BSA_RC_SUCCESS | The specified XBSA environment variable has been set. |