To specify a location from which directory objects are to be exported with the BatchExport function, use the pszBasePoint and pszContainer members of the BEXPORT_PARMS structure as follows:
/o=MyOrg/ou=MySite/cn=Recipients/cn=Me
/o=MyOrg/ou=MySite
An example of an RDN for pszContainer is:
/cn=Recipients/cn=Me
If used with the basepoint /o=MyOrg/ou=MySite
, the container specified with the RDN /cn=Recipients/cn=Me
is:
/o=MyOrg/ou=MySite/cn=Recipients/cn=Me
An example of an DN for pszContainer is:
/o=MyOrg/ou=MySite/cn=Recipients
If pszContainer is expressed as a DN, pszBasePoint is used if the container is specified on a per-object basis (Obj-Container is specified in the import file or in the structure passed in the pAttributes parameter of DAPIWrite).
An example of partially qualified DN for pszContainer is:
Recipients/cn=Subcontainer
To unambiguously identify the container, the value for pszContainer expressed as a partially qualified DN is combined with the value for pszBasePoint.
If pszBasePoint in BEXPORT_PARMS is NULL, the BatchExport function starts object extraction from the current site object, which is the site where the specified DSA resides. If pszBasePoint in BEXPORT_PARMS is "" (a zero-length string), the BatchExport function uses the current organization object as the basepoint. If pszContainer is NULL, the export operation is executed as if pszContainer has the value of pszBasePoint. These special cases are summed up in the following table.
Export Points for Special Cases of pszBasePoint and pszContainer
Member | Value | Export Point |
---|---|---|
pszBasePoint | NULL | Site object of the active server. |
pszBasePoint | "" | Organization object. |
pszContainer | NULL | Treats the basepoint as the default export container (as if pszContainer acquires the value of pszBasePoint). |