Extracting Security Information

The following steps provide an overview of how to extract security information from an application. These steps assume that an application has previously been opened with one of the OpenApplication methods.

Tip:

For an example that illustrates these steps, see Example for Extracting Security.

  To extract security information:

  1. Set an object reference to the HsvSecurityLoadACV object.

  2. Point to the application from which data is being extracted by calling HsvSecurityLoadACV.SetSession. For SetSession’s argument, pass the HsvSession object reference that was returned by HsxClient.OpenApplication or HsxClientUI.OpenApplication.

  3. Set an object reference to the IHsvLoadExtractOptions interface with the HsvSecurityLoadACV.ExtractOptions property.

  4. Optional. By default, users and groups, security classes, role access definitions, and security class access definitions are extracted. To override the defaults for these or the other extract options, specify the values for these options. The available extract options are listed in Security Extract Options.

  5. Extract the security information by calling HsvSecurityLoadACV.Extract. Extract takes the file names and paths of the extract file and of the log file.