Open a container

Use the SmsOpenContainer function to open a container for the type of object that you want to access in the site database.

The SmsOpenContainer function takes three parameters:

• The type of container
• A handle to the specified database connection
• A handle that is assigned the handle to the container. You use the handle to manage the container.

Note that you can open multiple containers. For example, you could open two job containers to handle two types of job folders independently—one with filters set to get Run Command On Workstation folders and another container with filters set to get Share Package On Server job folders.

Example:

// Use SmsOpenContainer to open a job container.
cType = C_JOB; // Set container type to job.

stat = SmsOpenContainer( cType,       // Type of container.
                         hConnect,   // Handle to database 
                                     // connection.
                         &hContainer // Assign handle to 
                                     // container to hContainer. 
                       );