The OperationgSystem Service Class

The service class OperatingSystem performs those operations that require direct access to the operating system that cannot implemented in a platform independent way. This implementation is provided for Windows platforms MSCPLAT. Other platforms would require their own version.

The method OperatingSystem_CopyFile

Prototype

The OperatingSystem_CopyFile method does a file copy in as efficient a method as possible. If the destination file already exists, it will be overridden. Its parameters are as follows:

If the copy succeeds, the return value is nonzero, else the return value is zero.

The method OperatingSystem_DeleteDirectory

Prototype

The OperatingSystem_DeleteDirectory method deletes a named directory. Its parameter is:

If the directory is successfully deleted, then a zero is returned. If the directory cannot be deleted, then a one is returned.

The method OperatingSystem_GetGuid

Prototype

The OperatingSystem_GetGuid method returns a created GUID string. A GUID is a Globally Unique Identifier, a unique 128-bit number that is used to identify a particular component, application, file, database entry, or user. This method uses the operating to create such an identifier in the commonly used string form. Each call to this method creates a new unique GUID. Its parameters are as follows:

The method returns the length of the GUID string as returned.

The method OperatingSystem_GetFileInfo

Prototype

The method OperatingSystem_GetFileInfo gets information about a specific file from the operating system. This information is as follows:

The parameters of the method are as follows:

The method OperatingSystem_GetLibraryMethod

Prototype

The OperatingSystem_GetLibraryMethod method gets the execution handle to a method in a loaded a dynamic link library. Its parameters are as follows:

This method returns an execution handle to the method if all went well; else it returns a NULL.

The method OperatingSystem_GetTime

Prototype

The OperatingSystem_GetTime method returns the current time in milliseconds. It has no parameters.

The method OperatingSystem_GetProgramName

Prototype

The OperatingSystem_GetProgramName method obtains the name of the currently executing program. This name is typically used to determine the names of corresponding startup files. Its parameters are as follows:

The method OperatingSystem_LoadLibrary

Prototype

The OperatingSystem_LoadLibrary method loads a dynamic link library and returns the handle to its information. Its parameter is:

This method returns an opaque handle to the loaded library information if all went well; else it returns a NULL.

The method OperatingSystem_MakeDirectory

Prototype

The OperatingSystem_MakeDirectory method makes a directory in the file system. Its parameter is:

If the directory is successfully created, then a zero is returned. If the directory cannot be created, then a one is returned.

The method OperatingSystem_ReadFileDirectory

Prototype

The OperatingSystem_ReadFileDirectory method reads the file directory one entry at a time. It is used to obtain a listing of all files in a directory. The information about each file is stored in a tOperatingSystem_FileInfo structure whose members are as follows:

The parameters of the method are as follows:

If information about a first or next file is being returned, then a zero is returned. If no more files are present, a one is returned.

The method OperatingSystem_UnloadLibrary

Prototype

The OperatingSystem_UnloadLibrary method unloads a dynamic link library. Its parameter is: