Security Load Options

For each security load option, the following table lists the constant that identifies the option and the corresponding Name property — either the constant or the name can be passed to IHsvLoadExtractOptions.Item. The table also describes each option and the type of information to be passed to IHsvLoadExtractOption.CurrentValue.

Tip:	For information on Item, see Item. For information on CurrentValue, see CurrentValue.

Table 74. Security Load Options

Constant	Load Option Information
HSV_SECURITYLOAD_OPT_AUTHENTICATE_USERS	Name property: ValidateUsers Usage: Determines whether the usernames and user groups specified in a load file will be authenticated as valid Windows users. Pass to CurrentValue: Boolean — TRUE to validate users, FALSE to allow users to be loaded without validation. Tip: If the ValidateUsers option is set to TRUE and the load file contains invalid usernames or user groups, Load’s pvbWarnings argument returns TRUE and the invalid user details are noted in the log file. For details, see Load.
HSV_SECURITYLOAD_OPT_CLEAR_ALL	Name property: ClearAll Usage: Determines whether existing security information will be cleared before the file is loaded. Pass to CurrentValue: Boolean — TRUE to clear existing information, FALSE otherwise.
HSV_SECURITYLOAD_OPT_DELIMITER_CHAR	Name property: Delimiter Usage: Specifies a load file’s delimiter. Pass to CurrentValue: String — a valid delimiter character. The ValidationList property returns the valid delimiters.
HSV_SECURITYLOAD_OPT_ROLE_ACCESS	Name property: RoleAccess Usage: Determines whether role access definitions will be loaded. Pass to CurrentValue: Boolean — TRUE to load role access definitions, FALSE otherwise.
HSV_SECURITYLOAD_OPT_SECURITY_CLASS_ACCESS	Name property: SecurityClassAccess Usage: Determines whether security class access definitions will be loaded. Pass to CurrentValue: Boolean — TRUE to load security access definitions, FALSE otherwise.
HSV_SECURITYLOAD_OPT_SECURITY_CLASSES	Name property: SecurityClasses Usage: Determines whether security classes will be loaded. This option is supported only for Classic applications. Pass to CurrentValue: Boolean — TRUE to load security classes, FALSE otherwise. Caution! If you attempt to load security classes into a Performance Management Architect application, Load will fail.
HSV_SECURITYLOAD_OPT_USERS	Name property: Users Usage: Determines whether usernames and user groups will be loaded. Pass to CurrentValue: Boolean — TRUE to load usernames and user groups, FALSE otherwise.