NDAP Controls (ActiveX Controls for Novell Services)

1.0 Introduction
2.0 What's New
2.1 General
2.2 Novell Directory Authenticator Control
3.0 Installation
4.0 Documentation
5.0 Control Dependencies
6.0 Sample Programs
7.0 Known Issues
7.1 Directory Control
7.2 Network Selector Control
7.3 Visual Basic Samples
7.4 Uninstalling the Controls
8.0 Legal Notices

1.0 Introduction

NDAP Controls for Novell Services abstracts NetWare Services into ActiveX Controls. The components are packaged for quick and easy use in Windows Visual Builder and other development tools, such as Visual Basic, Delphi, PowerBuilder, Active Server Pages for the Internet Information Server, Windows Scripting Host, and Internet Explorer.

The NDAP controls are dependent on the Novell Client for Windows and use Novell Directory Access Protocol (NDAP) for Novell eDirectory operations. The controls support full access to eDirectory, and provide administration capabilities for NetWare servers, print queues, volumes, users, groups, etc.

The NDAP controls provided by Novell are:


2.0 What's New


2.1 General

All controls are digitally signed using new Novell Software Publishing Certificate.


2.2 Novell Directory Authenticator Control

Fixed the issue with PasswordExpirationTime property when the value was greater than the year 2038.


3.0 Installation

To install the components on a Windows workstation:

  1. Run the setup file, activex_ndap.exe.

  2. Follow the Install Wizard.

    To install, launch the setup file from Windows Explorer. The install will extract and copy the controls. By default, the root installation directory is c:\Novell\NDK\ActiveX.

  3. Run regsvr32 on the controls to register the controls you want to use.

After successful installation, the NDAP entry is added in the 'ActiveX Controls for Novell Services' program entry in the Windows Start Menu.

To register the controls, click Start->Programs->ActiveX Controls for Novell Services->NDAP ->Register Controls. You can also register the controls by running REGOCX.BAT file from the command prompt.

You can unregister the controls any time by using unregocx.bat. The batch files are present in the installation directory.

All the controls have been digitally signed using the Novell Software Publishing Certificate to guarantee their authenticity.


4.0 Documentation

The primary documentation for the controls is the Microsoft HTML Help file, Glossary.chm, and the Schema HTML Help file, dsschema.chm. The Schema help file answers questions about eDirectory and identifies elements of the base Schema. Use the object browser within your visual builder tool to discover the methods, properties, events, and subordinate objects of individual components.

To meet the requirements of Section 508 of the Rehabilitation Act of 1973, Novell is migrating its Windows online help systems from WinHelp to Microsoft HTML Help. Because the HTML Help uses Internet Explorer (version 4.0 or later) as the viewer for HTML Help, therefore, to access online help for ActiveX Controls for Novell Services, Internet Explorer 4.x or later must be installed.


5.0 Control Dependencies


For all controls, the following are required:

The additional dependencies for each control are:


NWDir.ocx, NWSess.ocx, NWVolA.ocx, NWBrowse, NWDirA.ocx, and NWDPPtrA.ocx


NWSrvA.ocx


NWAppA.ocx


NWSelect.ocx


NWUsrGrp.ocx


NWSecStr.ocx


NWDirQ.dll, NWDirAuth.dll, and NDSDomain.dll


6.0 Sample Programs

Visual Basic sample programs are provided to show the use of the controls from various Visual Builder environments. The samples can be downloaded from the NDK site. Visual Basic 6 or later is required to view the samples.

Many other tools support the use of ActiveX Controls, and you may find these components a good replacement for more traditional SDK programming even when using them from C /C++.


7.0 Known Issues


7.1 Directory Control

As many fields in the directory are protected by eDirectory, users may not be able to read or write into these fields. If you have difficulties accessing a given Field value, try logging in as an Administrator to ensure that you have the maximum privileges and then check the spelling of the Field Name.

When recursively navigating a potentially large directory tree, performance can become an issue. To circumvent this issue, try to design your program so that it only fills one level of the tree at a time, or display the hourglass mouse cursor during any lengthy operations.

Since the Directory Control is capable of modifying the eDirectory schema information on a NetWare server, ensure that all testing and debugging activities are done on a private test network rather than on a production server. Changes to the schema can be difficult to undo, and may be replicated around the network - only experienced programmers who fully understand eDirectory should deploy this type of code on a production network.


7.2 Network Selector Control

If the fullname contains a valid tree name and an invalid context, the control dialog box does not show the default context.


7.3 Visual Basic Samples

The Visual Basic samples were written with Visual Basic 6.0 with the Service Pack 3 applied. If you get an error trying to load a form that has any of Microsoft's common controls such as ListView or ImageList, you will need to update the comctl32.ocx control to a newer version or install the Service Pack 2 or later. You can download the Service Pack from the Microsoft Web site.


7.4 Uninstalling the Controls

You need to unregister the controls in order to uninstall them.

  1. To unregister, click Start > Programs >ActiveX Controls for Novell Services Unregister controls or run UNREGOCX.BAT at the command prompt.

  2. To uninstall the controls, click Start->Control Panel >Add/Remove Programs > select NDK: NDAP Controls Software > click Add/Remove.


8.0 Legal Notices

Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.

Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.

You may not export or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export regulations or the laws of the country in which you reside.

All files provided in this release are subject to the Novell Developer Kit license Agreement and Separate Limited Warranty, which can be found in the license.txt file provided in this download.

Copyright © 2004 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.

Novell and NetWare are registered trademark of Novell, Inc. in the United States and other countries.

All third-party trademarks are the property of their respective owners.