NOVELL TECHNICAL INFORMATION DOCUMENT

TITLE:              Sample -NWDSSearch, NWDSRead and NWDSList.
DOCUMENT ID:        TID021878
DOCUMENT REVISION:  A
DATE:               19OCT94
ALERT STATUS:       Yellow
INFORMATION TYPE:   Issue
README FOR:         XDSA1.EXE

NOVELL PRODUCT and VERSION:
NLM SDK for NetWare 4.0 1.0c

ABSTRACT:

This self extracting zip file contains sample code that provides access to NDS
using a simplified streams-like interface.

-----------------------------------------------------------------
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.
-----------------------------------------------------------------

ISSUE

DSACCESS files show how to use the NWDSSearch, NWDSRead and NWDSList api calls
to access NDS.  They are organized in a way to provide a streams like
interface to them: allocating a handle, initiating the operation, reading data
and closing the handle.  It demonstrates how to allocate and initialize
buffers as well as getting information from buffers.

DSACDEMO.NLM shows how to use the dsaccess library to search, read and list
the directory.  This example returns phone numbers for users that have one. 
The application asks you to login to NDS by providing an administrator name
and password.  Provide a typed distinguished name for the user since default
context is typed, in 4.1 any name format will work.  Since connection 0 cannot
access NDS like it can the bindery, the login is required.

The syntax and output of DSACDEMO are described below:

Syntax: load DSACDEMO <base object to find telephone numbers from>

Output: Search results-showing telephone numbers of all user objects found
below the base object;  read results-showing the telephone numbers of the
first object found in the search results; and list results-showing all objects
below the base object specified.


Self-Extracting File Name:  XDSA1.EXE     Revision:  A

Files Included     Size     Date      Time

\
   XDSA1.TXT         (This File)
  DSACCESS.C      30637   10-21-94   11:51a
  DSACCESS.H       4386   10-20-94    3:40p
  DSACDEMO.C      11972   10-21-94   11:51a
DSACDEMO.NLM      20801   10-21-94    4:41p


DSACCESS.C     Streams like interface source code.
DSACCESS.H     Prototypes and macro definitions for using interface.
DSACDEMO.C     Sample source for using interface.
DSACDEMO.NLM   Sample executable.


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


ÿ