ACI API 24.1

# 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");

Copyright 2023 Open Text
Version 24.1 | Last updated December 2023

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL ACI API 24.1

Topic Title: aciObjectSetUserSecurityInfo