|
AllowArchive |
Scroll |
This functions decides if a User is able to archive/create a new version of a specific document. It's called every time a user tries to archive a document.
public int AllowArchive([in] object vUser, [in] object vIxData, [in] int nOldDocNo) |
Arguments
vUser
The User, who wants to archive a document (see User).
vIxData
The Index Data of the document (see Index Data).
nOldDocNo
Contains the old Document Number if the user tries to create an new version of an existing document.
Return
Return GRANT (= 1) if the user should be allowed to archive the document, else return NONE (= 0) or REVOKE ( = 2). If you want to use the Thereforeā¢ Default Rights return UNKNOWN(= 9) and if that function is not implemented throw a new System.Runtime.InteropServices.NotImplementedException. This will use Thereforeā¢ Default Rights and not call that function in future cases.
Return Value |
Right |
0 |
NONE |
1 |
GRANT |
2 |
REVOKE |
9 |
UNKNOWN - Use Thereforeā¢ Defaults |
NotImplementedException |
Use Thereforeā¢ Default Rights and do not call that function again |
Remarks
This Function is only called if the user has the corresponding Rights in Thereforeā¢. That means AllowArchive is only called if the if the user already passed the Thereforeā¢ Security Check and is allowed to archive a document as defined in the Thereforeā¢ Category Rights.
Therefore this function can only be used add additional restrictions on a per user level, not to give a user additional rights he does not have in Thereforeā¢.
C# Sample (Implementing the Function)
public int AllowArchive(object vUser, object vIxData, int nOldDocNo)
{
bool bAllow = false;
object[] oaUser = (object[])vUser;
int nUserNo = (Int32)oaUser[0];
string strUsername = (string)oaUser[1];
string strGroupNoList = (string)oaUser[2];
//DO ANYTHING -> set allow to true or false
if (bAllow)
return 1; //GRANT
return 2; //REVOKE
}
C# Sample (Function not implemented - Use default Thereforeā¢ Rights and don't call again)
public int AllowArchive(object vUser, object vIxData, int nOldDocNo)
{
throw new NotImplementedException();
}
See also:
Additional Information about vUser Object
Additional Information about vIndexData Object
