PA_DisposeHandle

version 2003

PA_DisposeHandle (handle)

Parameter	Type		Description
handle	PA_Handle	→	The handle to dispose

Description

The routine PA_DisposeHandle releases all storage allocated for handle, which becomes invalid.


   
    handle

is a


   PA_Handle

allocated by


   
    PA_NewHandle

.
Example

   Handle h;
   h = PA_NewHandle( 256 );
   if ( h )
   {
      /* do whatever you want with the handle */
      PA_DisposeHandle( h );
   }

See Also

PA_NewHandle .

Error Handling

Use PA_GetLastError to see if an error occurred (not a valid handle, etc.).