![](https://pdfstore-manualsonline.prod.a.ki/pdfasset/a/73/a73a4b49-d7f1-4c0b-9164-d43628ae57b6/a73a4b49-d7f1-4c0b-9164-d43628ae57b6-bge3.png)
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