ADMINReqChkAccessNewReplica

Function : Administration Process

ADMINReqChkAccessNewReplica - Create a "Check Access for New Replica Creation" request.

#include <adminp.h>
STATUS LNPUBLIC ADMINReqChkAccessNewReplica(

    DBHANDLE  dbhAdmin4,
    char far *chAuthor,
    char far *chSrcServer,
    char far *chSrcPathName,
    char far *chTitle,
    DBREPLICAINFO *Replicainfo,
    char far *chDesServer,
    char far *chDesPathName,
    ADMINReqParams far *arpAdminReqParamsPtr,
    WORD  wAdminReqParamsSize);

Description :

This function creates a "Check Access for New Replica Creation" request in the Administration Requests database (admin4.nsf).

Parameters : Input : dbhAdmin4 - Handle of the Administration Request database (admin4.nsf) that is the destination of the created Admin Request note.

chAuthor - A pointer to the Author's name (hierarchical names MUST be in canonical format).

chSrcServer - A pointer to Source Server name (hierarchical names MUST be in canonical format).

chSrcPathName - A pointer to source file name including path relative to the Domino data directory.

chTitle - A pointer to the Title of the database being replicated.

Replicainfo - Replicainfo - A pointer to source database Replicainfo.

chDesServer - A pointer to destination Server name (hierarchical names MUST be in canonical format).

chDesPathName - A pointer to destination file name including path relative to the Domino data directory.

arpAdminReqParamsPtr - Pointer to an ADMINReqParams structure.

wAdminReqParamsSize - Size of the buffer (ADMINReqParams structure) that the arpAdminReqParamsPtr parameter points to.

Output : (routine) - Return status of the call - indicates either success or what the error is.

NOERROR

ERR_xxx - Error returned by lower level functions. Call OSLoadString to interpret code.

Sample Usage :

if (error = NSFDbReplicaInfoGet (hSrcDB, &replica_info))
{
 NSFDbClose (hSrcDB);
 return (ERR(error));
}


 if (error = NSFDbOpen (AdminDBPath, &hAdminReq))
{
 NSFDbClose (hSrcDB);
 return (ERR(error));
}

if (error = ADMINReqChkAccessNewReplica (
 hAdminReq,
 "CN=Alan Admin/O=Org",
 SOURCE_SRVR,
 SOURCE_FILE,
 DB_TITLE,
 &replica_info,
 TARGET_SRVR,
 TARGET_FILE,
 &ARPptr,
 sizeof(ARPptr)) )
{
 NSFDbClose (hSrcDB);
 NSFDbClose (hAdminReq);
 return (ERR(error));
}