Sm_PolicyApi_AddUserDirToDomain()

Programming Guides › Programming Guide for C › Policy Management API Guidance › Function Declarations for the Policy Management API › Sm_PolicyApi_AddUserDirToDomain()

Sm_PolicyApi_AddUserDirToDomain()

Associates the directory object identified by pszUserDirOid with the domain identified by pszDomainOid. The directory object is appended to the end of the search order.

Type

User directory function, global scope.

Syntax

int SM_EXTERN Sm_PolicyApi_AddUserDirToDomain (
   void*          pSessionHandle,
   const char*    pszUserDirOid,
   const char*    pszDomainOid
);

Parameter	I/O	Description
pSessionHandle	I	A pointer to an internal Policy Management API data structure. The structure holds information about the administrator session and the client session.
pszUserDirOid	I	A null-terminated string containing the object identifier of an existing user directory.
pszDomainOid	I	A null-terminated string containing the object identifier of an existing domain.

Returns

Sm_PolicyApi_Success. The add operation was successful.
Sm_PolicyApi_Failure. The add operation was not successful.
Sm_PolicyApi_NoSession. There is no valid administrator session.
Sm_PolicyApi_InvalidHandle. There was no valid initialization prior to this call.
Sm_PolicyApi_NoPrivilege. The administrator does not have the privilege to add a user directory to a domain.
Sm_PolicyApi_InvalidOid. A user directory or domain OID was not found.
Sm_PolicyApi_DuplicateEntry. The user directory exists in the user directory collection of the domain.