Synopsis:

        sys_gethandle(file_handle)

Arguments:

        file_handle       -   The file handle

Description:    This function is used to convert the internal file_handle returned from  sys_fhopen() into a hex-string representation of the actual operating system handle.     Hex strings are used to represent binary values as strings where each byte of the binary value is represented by a two charater hexidecimal string.

The value returned in this case will be an 8 character hex-string representing the 4 byte Windows file handle.  

This function is typically used by other DLL libraries to access a real operating system file handle when passed the internal file handle returned by sys_fhopen().

(For example the function SMplayh(chan,filehandle) in the CXACUDSP library uses this function)

It is unlikely that this funtion will be used from your code.

Return Value:  

Returns the hexidecimal string representation of the actual Window file handle.