Platform SDK: Exchange Server |
The DIRSYNC sample application writes exported data to files and reads imported data from files. Although DIRSYNC communicates with the directory service using directory access functions, the file format it requires for import operations (and generates during export operations) differs from that used by the directory access functions.
The following is a sample of the DIRSYNC file format, which is based on the Microsoft Mail 3.2 IMPORT utility file format:
# Sample DIRSYNC import/export file A /o=Microsoft/ou=WGA/cn=Recipients/cn=JerryWh - Display-Name:Jerry Wheeler M /o=Microsoft/ou=WGA/cn=Recipients/cn=West Coast/cn=KevinY - Display-Name:Kevin Yim D /o=Microsoft/ou=WGA/cn=Recipients/cn=KevinY
Each line is prefixed by a character that indicates how the line should be processed.
Prefix | Type | Notes |
---|---|---|
A | Add | Export: New directory entry. Import: Add new directory entry. |
M | Modify | Export: Modified directory entry. Import: Modify directory entry. |
D | Delete | Export: Deleted directory entry. Import: Delete directory entry. |
- | Attribute | Directory object attribute. |
# | Comment | Comment line. The rest of the line after the hash character is ignored. |
Here is an example of the import/export file syntax used by the DIRSYNC sample application:
data-list : data-section data-section data-list data-section : add-section modify-section delete-section comment-line add-section : add-line attribute-section modify-section : modify-line attribute-section delete-section : delete-line attribute-section : attribute-line attribute-line attribute-section add-line : A space-character RDN EOL modify-line : M space-character RDN EOL delete-line : D space-character RDN EOL attribute-line : - space-character attribute-label : attribute-value (opt) EOL comment-line : # string EOL EOL : CR LF attribute-value : constant string hex-string quoted-string quoted-string : " string " hex-string : \x hex-string-data hex-string-data : hex-character hex-character hex-string-data hex-character : one of 0 1 2 3 4 5 6 7 8 9 A B C D E F a b c d e f
Important Do not enter spaces between attribute names, the colon delimiter, and attribute values.