Function DE Version 1.90

@NotesIDFileNewCertifier

NotesAdmin

Syntax

@NotesIDFileNewCertifier(RetCTXHandle;IDTYPE;RegServer;Country;Organization;OrganizationUnit;Password;
IDFileName;Location;Comment;MailServerName;MailFileName;ForwardAddress;
FLAGS;FNKeyWidth;MinPasswordLen;ErrorText);

Beschreibung

Erzeugen einer neuen Notes Certifier ID.
Optional kann zudem dein Eintrag im Namen&Adressbuch vorgenommen werden und ein Mail-File für den neuen Benutzer angelegt werden.
Die Steuerung erfolgt im wesentlichen über FN IDTYPE und FN FLAGS.
Alle anderen Parameter sind weitgehend optionaler TEXT und können durch "" angegeben werden.
Ausnahmen sind FN MinPasswordLen.

FN
IDTYPE
KFM_IDFILE_TYPE_ORG      2      /* Organization certifier          */
                     Organization muß angegeben werden,RetCTXHandle und OrganizationUnit muß "" (NULLSTRING) sein.
KFM_IDFILE_TYPE_ORGUNIT      3      /* Organizational unit certifier       */
                     OrganizationUnit muß angegeben werden,RetCTXHandle muß ein gültiger Handle sein,Organization und Country muß "" (NULLSTRING) sein.

FN FNKeyWidth
Hier muß 0 angegeben werden.

FN FLAGS
fREGCreateIDFileNow      0x0001   /* set to create the ID-file */
fREGUSARequested         0x0002   /* set if an US or Canadian ID should be created */
fREGCreateMailFileNow      0x0004   /* set if the mail file should be created */
fREGCreateAddrBookEntry      0x0008   /* set if N&A entry should be created or modified */
fREGOkayToModifyID      0x0010   /* set to overwrite existing ID-file */
fREGOkayToModifyAddrbook   0x0020   /* set to modify existing N&A entry */
fREGSaveIDInFile         0x0040   /* set to create an ID-file on the harddisc */
fREGCreateLimitedClient      0x0080   /* set to create a Lotus Mail user */
fREGCreateDesktopClient      0x0100   /* set to create a Lotus Notes Desktop user */
fREGSaveIDInAddrBook      0x0200   /* set to attach the ID to the N&A entry */
fREGCreateMailFileUsingAdminp   0x0800   /* set to use admin process to create mail-DB */
fREGCommonPW         0x1000   /* set to use with NT User Manager extension dll */

TEXT ERRORTEXT (Rückgabewert)
Pfadname der Datei, bei deren Zugriff ein Fehler aufgetreten ist.

@Return-Wert:
Wenn die @Funktion erfolgreich ausgeführt wurde wird 1 zurückgegeben ansonsten ein @ERROR.

Beispiel for IDType=KFM_IDFILE_TYPE_ORG:

RetCTXHandle:="";
IDType:=2;
RegServer:="";
Country:="DE";
Organization:="TestOrg";
OrganizationUnit:="";
Password:="Cert";/*Password für neue ID*/
IDFileName:="D:\\TMP\\IDFILES\\Cert.ID";
Location:="";
Comment:="";
MailServerName:="";
MailFileName:="";
ForwardAddress:="";
Flags:=121;
FNKeyWidth:=0;
MinPasswordLen:=0;

RetBool:=@NotesIDFileNewCertifier(RetCTXHandle;IDType;RegServer;Country;Organization;OrganizationUnit;
Password;IDFileName;Location;Comment;MailServerName;MailFileName;ForwardAddress;
Flags;FNKeyWidth;MinPasswordLen;ErrorText);

@LogReport(RetBool);
@LogReport(ErrorText);

Beispiel for IDType=KFM_IDFILE_TYPE_ORGUNIT:

RetECPW:=@NotesIDFileEncodePassword("Cert");
ExpTD1:=[10.10.2010 10:10:10];
CertifierPath:="D:\\TMP\\IDFILES\\Cert.ID";
RetCTXHandle:=@NotesIDFileOpenCertifierCtx(CertifierPath;RetECPW;"WU-ENT-BER-50/WHATSUP/DE";ExpTD1;RETTEXT5;RETNUMBERHIERAR6;RETNUMBERFILEV7);

IDType:=3;
RegServer:="";
Country:="";
Organization:="";
OrganizationUnit:="TestUnit";
Password:="Unit";/*Password für neue ID*/
IDFileName:="D:\\TMP\\IDFILES\\Unit.ID";
Location:="";
Comment:="";
MailServerName:="";
MailFileName:="";
ForwardAddress:="";
Flags:=121;
FNKeyWidth:=0;
MinPasswordLen:=0;

RetBool:=@NotesIDFileNewCertifier(RetCTXHandle;IDType;RegServer;Country;Organization;OrganizationUnit;
Password;IDFileName;Location;Comment;MailServerName;MailFileName;ForwardAddress;
Flags;FNKeyWidth;MinPasswordLen;ErrorText);

@LogReport(RetBool);
@LogReport(ErrorText);

RetCTXHandle:=@NotesIDFileCloseCertifierCtx(RetCTXHandle);