aciObjectSetUserSecurityInfo

Call the aciObjectSetUserSecurityInfo function to set the user-level security for documents in a repository.

Syntax

aciObjectSetUserSecurityInfo (
   t_aciObject* pObject,
   char* szRepository,
   char* szName,
   char* szValue)

Arguments

Arguments Type/Description
pObject t_aciObject*  A pointer to an ACI_CONNECTION type object.
szRepository char*  A pointer to a repository.
szName char*  A pointer to a security field name, which is one of the following values:
  • ACI_SECURITY_USERNAME. User name.
  • ACI_SECURITY_PASSWORD. Password.
  • ACI_SECURITY_GROUP. Group.
  • ACI_SECURITY_DOMAIN. Domain.
  • ACI_SECURITY_EXTENDED. Other information.
szValue char*  The value to associate with the security field.

Discussion

This function sets security information for a user, which is used to determine access to documents in an IDOL server. Enter the repository type with szRepository (this must match the name of the IDOL server configuration section in which you make the security settings for this type of repository). To enter the security information, set the security field with szName and the value for the field with szValue.

For information about the szValue arguments to set for various repositories, see Security Information Values.

The information that you set with this function is encrypted and automatically added as the security string that is sent with an action to the ACI server. You do not need to set this parameter separately with a call to the aciObjectParamSetString function.

You can only call this function for an ACI_COMMAND type ACI object.

Returns

An ACI error code.

Examples

aciObjectSetUserSecurityInfo(pCommand, "netware",
   ACI_SECURITY_EXTENDED, "x");
aciObjectSetUserSecurityInfo(pCommand, "nt", 
   ACI_SECURITY_DOMAIN, "Office");
aciObjectSetUserSecurityInfo(pCommand, "nt", 
   ACI_SECURITY_GROUP, "techusers");
aciObjectSetUserSecurityInfo(pCommand, "notes",
   ACI_SECURITY_PASSWORD, "pass1234");
aciObjectSetUserSecurityInfo(pCommand, "notes",
   ACI_SECURITY_USERNAME, "jsmith");