GUI ScreenIO for Windows

 ScreenIO.com


CreateDirectory

The CreateDirectory API creates a directory.  If the parent directory does not exist, that directory is created, and so on up to the root of the drive.  If the drive letter or path is un-writeable (either because it does not exist or the user does not have rights) this API will fail.

Client/Server issues

If running in client/server mode, this API will create a directory at the specified location on the client

To create a directory on the server set the following 88 to true:

     SET WIN32API-EXECUTE-API-ON-SERVER TO TRUE

Files

Files available to copy to your system:

Usage

     COPY WIN32API.
     COPY CREATDIR.

* ------------------------: Call the API.

     SET API-CREATDIRECTORY TO TRUE.

     CALL 'GSWINAPI' USING WIN32API-PARMS
                     CREATEDIRECTORY-NAME
                           WIN32API-B
                           WIN32API-C
                           WIN32API-D
                           WIN32API-E
                           WIN32API-F.

Parameters specific to this function

CREATEDIRECTORY-NAME

Pathspec of desired directory, starting at the root of the drive. Higher level directories do not need to exist prior to the call.  All directories up to and including the named directory will be created as necessary.

Note:  You may want to review the information on This Page about determining the normal place to create directories for storing Application Data as recommended by Microsoft.  For the most part, Microsoft recommends storing Application Data in an application specific directory under the path that is returned when you do a GetFolderPath with the key of GFP-APPDATA or GFP-MYDOCUMENTS. These directories are guaranteed to exist and be write-able by the user without administrative privileges.  Your application may or may not be able to write on other portions of the directory structure depending on security settings.

WIN32API-PARMS - Used in all GSWINAPI calls

This argument is standard for all CALLs to GSWINAPI. It is used to select the desired API or function, and to return the status of the operation.

WIN32API-RC

Used to return the status of a call to GSWINAPI.  A value of zero is a failure, any other value indicates success.

Recommended usage is to test the 88-level value WIN32API to see if it worked, then to use the text error message to see why it failed.

* ------------------------: If function failed,
*                         :   display the error in a message box.
*
     IF WIN32API-FAILED
       MOVE WIN32API-ERROR-TEXT TO panel-MESSAGE-TEXT
       SET panel-MESSAGE-IN-MESSAGEBOX TO TRUE.

WIN32API-ERROR-CODE

Error code that was returned by Windows.  This is not generally useful unless you have the Windows Platform SDK documentation available to you.

WIN32API-ERROR-TEXT

Plain-text error message that describes why the operation failed.

WIN32API-A through WIN32API-F

The number of these present varies depending on how many arguments are used by the desired function.  These are not used, but must be present because this CALL requires seven arguments.


2000-2006 Norcom, all rights reserved 

TOC

Send feedback to Norcom