ACI API 25.3
ACI API Programming Guide

# 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 a Content component data index. Enter the repository type with `szRepository` (this must match the name of the Content 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 2025 Open Text
Version 25.3 | Last updated July 2025

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: Knowledge Discovery ACI API 25.3

Topic Title: aciObjectSetUserSecurityInfo