IServerObjectAdmin.CreateServerDirectory Method

Creates a new server directory.

[Visual Basic .NET]
Public Function CreateServerDirectory ( _
) As IServerDirectory

[C#]
public IServerDirectory CreateServerDirectory (
);

[C++]
HRESULT CreateServerDirectory(
  IServerDirectory** ppSD
);

[C++]

Parameters
ppSD [out, retval]

  ppSD is a parameter of type IServerDirectory

Product Availability

Remarks

Both server objects and server applications typically need to write either temporary data or result data to some location in order for it to be delivered to, or presented to the end user. For example, a map server object's ExportMapImage method can create a image file which is then displayed on a web applicaiton. These files are typically transient and temporary by nature. For example, when a map server write's an image to satisfy a request from a web application, that image is needed only for the time it takes to display it on the web application. An application that creates check out personal geodatabases for download would provide a finite amount of time between which that geodatabase is created and when it can be downloaded.

Because server applications support many user sessions, these output files can accumulate and need to be periodically cleaned up. The server provides the cabability to automatically cleanup these output files if they are written to one of the server's output directories.

Use the CreateServerDirectory method to create a new server directory that you can pass as an argument to the AddServerDirectory method to add new server directories to your GIS Server. Once you have added the server directory, you can configure your server objects and server applications to make use of the server directory.

Note: server directories must be accessible by all host machines configured in the GIS server.

See Also