API Guide
601355 Rev A API Functions 2-177
Functions
VS_Drive_Destroy
The VS_Drive_Destroy deallocates a drive handle that was
allocated with VS_Drive_Create. A drive handle is used to
pass drive information to and from VolServ.
Synopsis VST_BOOLEAN VS_Drive_Destroy
( VST_DRIVE_HANDLE handle )
Arguments •handle = Drive handle to be destroyed.
Return Values VS_Drive_Destroy returns:
•VSE_TRUE - Successful execution.
•VSE_FALSE - API failure - The appropriate error code is
set in VSG_Error.
•VSE_ERR_BADHANDLE - Specified handle was not a drive
handle.
•VSE_ERR_NULLHANDLE - Specified handle was a null
pointer.
Example 1 /****************************************
*********
2*
3 * FUNCTION: vst_drive_handle
4*
5 * PURPOSE:
6 * This function tests a drive handle.
7*
8 * PARAMETERS:
9 * none
10 *
11 ****************************************
*********/
12 #ifdef ANSI_C