NOVELL TECHNICAL INFORMATION DOCUMENT

TITLE:  NDS C++ Library
README FOR:  DN511.EXE

NOVELL PRODUCTS and VERSIONS:
NetWare 4.1

ABSTRACT:

A C++ class library for NetWare Directory Services (NDS).  Described in the article "NDS Application Development Using C++" in the Jan/Feb 95 and Mar/Apr 95 issues of Novell Developer Notes.


-----------------------------------------------------------------
DISCLAIMER
THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
-----------------------------------------------------------------


SYMPTOM:

NDS C++ Library

SOLUTION: 

Implement the files found in DN511

Self-Extracting File Name: dn511.exe

Files Included     Size     Date      Time

..\
       DN511.TXT     (This file)
      ACCESS.CPP            3701          1-9-95      4:26:06 pm
     ADDRESS.CPP            3154         2-16-95     10:11:42 am
      AUDITC.CPP            2439         2-10-95      3:09:16 pm
      AUDITV.CPP            2790          1-9-95      4:21:32 pm
     CONTEXT.CPP            1095          1-9-95      4:25:34 pm
     DSAUDIT.CPP            9304          1-9-95      5:30:38 pm
       DSAUDIT.H            3997          1-9-95      5:32:38 pm
    DSBUFFER.CPP           15286          1-9-95      5:30:14 pm
      DSBUFFER.H            4488          1-9-95      5:32:34 pm
      DSCONN.CPP            5818          1-9-95      5:30:00 pm
        DSCONN.H            8252          1-9-95      5:32:28 pm
      DSCONNBU.H            2904          1-9-95      5:32:24 pm
    DSCONTEX.CPP            5115         1-12-95      3:56:10 pm
      DSCONTEX.H            7603          1-9-95      5:32:20 pm
        DSDEFS.H            4218         1-13-95      8:38:40 am
        DSDUMP.H            3110          1-9-95      5:32:10 pm
      DSFILE.CPP            4663          1-9-95      5:29:44 pm
        DSFILE.H            2987          1-9-95      5:32:04 pm
    DSFILTER.CPP            2352          1-9-95      5:29:36 pm
      DSFILTER.H            3773          1-9-95      5:33:38 pm
     DSINPUT.CPP            3795          1-9-95      5:29:24 pm
       DSINPUT.H            3937          1-9-95      5:33:34 pm
      DSITERAT.H            3095          1-9-95      5:33:28 pm
    DSLOCALE.CPP            4462          1-9-95      5:29:04 pm
      DSLOCALE.H            3520          1-9-95      5:33:24 pm
    DSOBJECT.CPP           11609         2-16-95     10:15:20 am
      DSOBJECT.H            5202         2-15-95     10:42:12 am
    DSOUTPUT.CPP            6094          1-9-95      5:31:32 pm
      DSOUTPUT.H            4584          1-9-95      5:33:16 pm
    DSPARTIT.CPP            3933          1-9-95      5:31:28 pm
      DSPARTIT.H            4698          1-9-95      5:33:10 pm
    DSSCHEMA.CPP            9689          1-9-95      5:31:22 pm
      DSSCHEMA.H            5189          1-9-95      5:35:14 pm
     DSVADDR.CPP           12712         2-16-95     10:14:26 am
       DSVADDR.H            4302         2-15-95      3:38:08 pm
     DSVALUE.CPP            7113         2-14-95      1:48:12 pm
       DSVALUE.H            5494         2-13-95      4:12:50 pm
     DSVCHAR.CPP            6660         2-13-95      1:24:10 pm
       DSVCHAR.H            3486         2-13-95      2:28:34 pm
      DSVINT.CPP            6194         2-13-95      1:14:26 pm
        DSVINT.H            3046          1-9-95      5:35:00 pm
       DSVLIST.H            5401         1-13-95      8:18:38 am
    DSVMULTI.CPP            4163         2-13-95      1:22:40 pm
      DSVMULTI.H            2829         1-12-95      5:57:36 pm
        LIST.CPP             901          1-9-95      4:27:54 pm
    LISTPART.CPP            1057          1-9-95      4:29:46 pm
       LOGON.CPP            1402         1-12-95      8:25:46 am
    NWNDSCPP.CPP            1989         1-12-95      2:00:34 pm
    NWNDSCPP.DEF             151        12-13-94      1:38:22 pm
      OBJECT.CPP            3949         1-12-95      1:52:54 pm
    PASSWORD.CPP             869          2-8-95      3:45:18 pm
    READUSER.CPP            2223          1-9-95      4:31:38 pm
      SCRIPT.CPP            1475          1-9-95      4:32:48 pm
      SEARCH.CPP            2833          1-9-95      4:35:54 pm
        SEARCH.H            1819         9-29-94      3:32:18 pm
      WLOGON.CPP            2744         1-12-95      1:55:20 pm
      WLOGON.DEF             167         12-8-94      3:50:26 pm
        WLOGON.H              86         12-9-94     10:48:40 am
       WLOGON.RC             544         12-9-94     11:58:42 am
     WOBJECT.CPP            3634         1-12-95      5:05:10 pm
     WOBJECT.DEF             169         1-12-95      5:02:56 pm
     WSEARCH.CPP            3079         1-13-95      8:46:16 am
     WSEARCH.DEF             171        11-25-94      1:49:54 pm
..\EXAMPLES\
      ACCESS.CPP            3701          1-9-95      4:26:06 pm
     ADDRESS.CPP            3154         2-16-95     10:11:42 am
      AUDITC.CPP            2439         2-10-95      3:09:16 pm
      AUDITV.CPP            2790          1-9-95      4:21:32 pm
     CONTEXT.CPP            1095          1-9-95      4:25:34 pm
        LIST.CPP             901          1-9-95      4:27:54 pm
    LISTPART.CPP            1057          1-9-95      4:29:46 pm
       LOGON.CPP            1402         1-12-95      8:25:46 am
    NWNDSCPP.CPP            1989         1-12-95      2:00:34 pm
    NWNDSCPP.DEF             151        12-13-94      1:38:22 pm
      OBJECT.CPP            3949         1-12-95      1:52:54 pm
    PASSWORD.CPP             869          2-8-95      3:45:18 pm
    READUSER.CPP            2223          1-9-95      4:31:38 pm
      SCRIPT.CPP            1475          1-9-95      4:32:48 pm
      SEARCH.CPP            2833          1-9-95      4:35:54 pm
        SEARCH.H            1819         9-29-94      3:32:18 pm
      WLOGON.CPP            2744         1-12-95      1:55:20 pm
      WLOGON.DEF             167         12-8-94      3:50:26 pm
        WLOGON.H              86         12-9-94     10:48:40 am
       WLOGON.RC             544         12-9-94     11:58:42 am
     WOBJECT.CPP            3634         1-12-95      5:05:10 pm
     WOBJECT.DEF             169         1-12-95      5:02:56 pm
     WSEARCH.CPP            3079         1-13-95      8:46:16 am
     WSEARCH.DEF             171        11-25-94      1:49:54 pm


Installation Instructions:

NDS C++ Library
===============

Here are some notes on using the C++ library.

Memory Model
------------
Only use the library in large memory models only. The stack size for certain API calls should be set to 8K. These calls include the login APIs.

Compile Definitions
-------------------
The following compile definitions should be used to when generating Windows applications or libraries. All these definitions are used in the file DSDEF.H. Users of MicroSoft C++ will have to modify the import/export macros.

DSCPP_WINDOWS  - includes WINDOWS.H file before NWNET.H.
DSCPP_IOSTREAM - includes IOSTREAM.H.
DSCPP_NWCALLS  - includes NWCALLS.H.

DSCPP_EXPORT   - declares all DS classes as _export.
DSCPP_IMPORT   - declares all DS classes as _import.

DSCPP_OLDVERSION - defines new functions introduced with SDK 4.1.

Examples
--------
There are 13 examples files, 11 DOS and 2 Windows.

ACCESS.CPP   - Modify an object's ACL.
AUDITC.CPP   - Display container audit information.
AUDITV.CPP   - Display volume audit information.
CONTEXT.CPP  - Translate dist-names to relatative dist-names.
LIST.CPP     - List objects in a container.
LISTPART.CPP - List partitions held on a server.
LOGON.CPP    - Attach to a server from DOS.
OBJECT.CPP   - Create and modify NDS user objects.
READUSER.CPP - Read NDS user data.
SCRIPT.CPP   - Read and modify NDS login scripts.
SEARCH.CPP   - Search for NDS users.
WLOGON.CPP   - Attach to a server from Windows.
WSEARCH.CPP  - Search for NDS users from Windows.

Auditing
--------
The auditing password used by AUDITCON is not compatible with the APIs, and vice versa.


-----------------------------------------------------------------
Any trademarks referenced in this document are the property of their
respective owners.  Consult your product manuals for complete trademark
information.
-----------------------------------------------------------------

