Sets a cluster-wide environment variable.
- Name [in]
The name of the environment variable.
- Value [in]
The value of the environment variable. If NULL or an empty string, the variable is deleted.
If the method succeeds, the return value is S_OK. Otherwise, the return value is an error code. To get a description of the error, call the ICluster::get_ErrorMessage method.
The sum of all environment variables is limited to 2,048 Unicode characters.
You can use this method to add, delete, or update an environment variable. However, you cannot delete or update the value of a CCP defined environment variables, such as CCP_CLUSTER_NAME. If you try to update the value of a CCP variable, you will get a duplicate entry.
To retrieve the cluster-wide environment variables, call the ICluster::get_EnvironmentVariables method.
To set task-specific environment variables, call the ITask::SetEnvironmentVariable method.
To retrieve the variable from within a task, call the Win32 function GetEnvironmentVariable.
|Compute Cluster Pack Client Utilities|