cwbUN_ReleaseSystemHandle

Purpose

Releases a system handle that contains the security (SSL) settings to be used for this iSeries ^(TM) system. The system handle is obtained using the cwbUN_GetSystemHandle function.

If the caller of this function has the last reference to the handle, the handle resources actually will be destroyed.

Syntax

CWBAPI unsigned int WINAPI cwbUN_ReleaseSystemHandle(
    cwbCO_SysHandle * systemHandle
    );

Parameters

cwbCO_SysHandle * systemHandle - input

Pointer to the handle of the system that was obtained on a cwbUN_GetSystemHandle call.

Return Codes

The following list shows common return values:

CWB_OK

Successful completion.

CWB_API_ERROR

The system handle could not be released.

Usage

When the caller of this function no longer needs the system handle for communications, the handle can be released.