/// <summary>
/// Resets all permissions any principals have on a SCO to the permissions of its parent SCO. If
/// the parent has no permissions set, the child SCO will also have no permissions.
/// </summary>
/// <param name="adobeConnectXmlApi">The adobe connect XML API.</param>
/// <param name="aclId">*Required.
/// The ID of a SCO, account, or principal
/// that a principal has permission to act
/// on. The acl-id is a sco-id, principalid,
/// or account-id in other calls.</param>
/// <returns>
/// <see cref="ApiStatus" />
/// </returns>
public static ApiStatus PermissionsReset(this AdobeConnectXmlAPI adobeConnectXmlApi, string aclId)
{
ApiStatus s = adobeConnectXmlApi.ProcessApiRequest("permissions-reset", String.Format("acl-id={0}", aclId));
return(s);
}
/// <summary>
/// Changes a user’s password. A password can be changed in either of these cases:
/// By an Administrator logged in to the account, with or without the user’s old password
/// By any Connect Enterprise user, with the user’s principal-id number, Login Name, and old password
/// </summary>
/// <param name="adobeConnectXmlApi">The adobe connect XML API.</param>
/// <param name="userId">The user identifier.</param>
/// <param name="passwordOld">The old password.</param>
/// <param name="password">The new password.</param>
/// <returns>
/// <see cref="ApiStatus" />
/// </returns>
public static ApiStatus PrincipalUpdatePwd(this AdobeConnectXmlAPI adobeConnectXmlApi, string userId, string passwordOld, string password)
{
ApiStatus s = adobeConnectXmlApi.ProcessApiRequest("user-update-pwd", String.Format("user-id={0}&password-old={1}&password={2}", userId, passwordOld, password));
return(s);
}
/// <summary>
/// Adds one or more principals to a group, or removes one or more principals from a group.
/// To update multiple principals and groups, specify multiple trios of group-id, principal-id,
/// and is-member parameters.
/// </summary>
/// <param name="adobeConnectXmlApi">The adobe connect XML API.</param>
/// <param name="groupId">The ID of the group in which you want to add or change members.</param>
/// <param name="principalId">The ID of the principal whose membership status you want to update. Returned by principal-info.</param>
/// <param name="isMember">Whether the principal is added to (true) or deleted from (false) the group.</param>
/// <returns>
/// <see cref="ApiStatus" />
/// </returns>
public static ApiStatus PrincipalGroupMembershipUpdate(this AdobeConnectXmlAPI adobeConnectXmlApi, string groupId, string principalId, bool isMember)
{
ApiStatus s = adobeConnectXmlApi.ProcessApiRequest("group-membership-update", String.Format("group-id={0}&principal-id={1}&is-member={2}", groupId, principalId, isMember ? 1 : 0));
return(s);
}
/// <summary>
/// Updates the permissions a principal has to access a SCO, using a trio of principal-id, aclid,
/// and permission-id. To update permissions for multiple principals or objects, specify
/// multiple trios. You can update more than 200 permissions in a single call to permissionsupdate.
/// </summary>
/// <param name="adobeConnectXmlApi">The adobe connect XML API.</param>
/// <param name="aclId">*Required.
/// The ID of a SCO, account, or principal
/// that a principal has permission to act
/// on. The acl-id is a sco-id, principalid,
/// or account-id in other calls.</param>
/// <param name="principalId">*Required.
/// The ID of a user or group who has a
/// permission (even if Denied or not set) to
/// act on a SCO, an account, or another principal.</param>
/// <param name="permissionId">*Required. <see cref="PermissionId" />.</param>
/// <returns>
/// <see cref="ApiStatus" />
/// </returns>
public static ApiStatus PermissionsUpdate(this AdobeConnectXmlAPI adobeConnectXmlApi, string aclId, string principalId, PermissionId permissionId)
{
ApiStatus s = adobeConnectXmlApi.ProcessApiRequest("permissions-update", String.Format("acl-id={0}&principal-id={1}&permission-id={2}", aclId, principalId, Helpers.EnumToString(permissionId)));
return(s);
}