Sm_PolicyApi_AddAdminToDomain()

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

Sm_PolicyApi_AddAdminToDomain()

Gives the specified administrator permission to administer the specified domain, and associates the administrator object identified by szAdminOid with the domain identified by szDomainOid.

Type

Administrator function, global scope.

Syntax

int SM_EXTERN Sm_PolicyApi_AddAdminToDomain (
   void*            pSessionHandle,
   const char*      pszAdminOid,
   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.
pszAdminOid	I	A null-terminated string containing the object identifier of an existing administrator.
pszDomainOid	I	A null-terminated string containing the object identifier of an existing domain.

Returns

Sm_PolicyApi_Success. The administrator was added to the domain.
Sm_PolicyApi_InvalidHandle. There was no valid initialization prior to this call.
Sm_PolicyApi_NoSession. There is no valid administrator session.
Sm_PolicyApi_NoPrivilege. The administrator does not have the privilege to add an administrator to a domain.
Sm_PolicyApi_InvalidOid. The administrator object identifier or the domain object identifier was not found.
Sm_PolicyApi_DuplicateEntry. The specified administrator object identifier already exists in the domain.

Email CA about this topic