//+-------------------------------------------------------------------------
//
//  THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
//  ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
//  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
//  PARTICULAR PURPOSE.
//
//  Copyright (c) Microsoft Corporation. All rights reserved.
//
//  WAB ASP Sample: Using ADSI and ASP to search Active Directory
//
//--------------------------------------------------------------------------

Description
===========
The WAB sample shows how an Active Server Page (ASP) can use ADSI to
search Active Directory.  The sample uses ActiveX Data Objects (ADO) to
search for a specified user or group name and retrieves information from
the objects returned by the search.

This sample uses the LDAP: provider and is suitable for Windows 2000 and
later networks running Active Directory.

Sample Files
============
  *  Banner.Gif
  *  Default.Asp
  *  Detail.Asp
  *  Global.Asa
  *  Group.Asp
  *  Person.Asp
  *  Print.Gif
  *  Search.Asp
  *  Search.Gif
  *  Search.Jpg

Running the Sample
==================
This sample requires that you install Microsoft Internet Information Services
on a Web server in the domain.  For example, the location of the Web server
might be www.fabrikam.com.

To run this sample
  1. Edit the Global.Asa file to include the appropriate domain name and
     user credentials for a query.  Change the lines

       Session("ADsDomain") = "YourDominDNSNameHere"
       Application("UserID") = "YourDomainHere\YourUserNameHere"
       Application("Password") = "yourPasswordHere"

     appropriately for your situation.  For example, for the Fabrikam.Com
     domain, this might be

       Session("ADsDomain") = "fabrikam.com"
       Application("UserID") = "FABRIKAM\administrator"
       Application("Password") = "password"

     Note that you usually should not hardcode this information.
  2. Copy all the sample files to the wwwroot folder of the Web server.
  3. On any computer in the domain using Microsoft Internet Explorer, enter
        "http://www.fabrikam.com/Default.Asp"
     in the Address field and select Go.
  4. In the resulting "Windows Address Book - ADSI" page, enter an alias,
     first name, last name, group name, or distribution list name in the
     Name field and select Search.

Example Output
==============
The sample produces HTML output similar to the following, which is for the
Fabrikam.Com domain when the search is for "user".

Search for:   user     

Name        Phone          Title                 Office      Department
 
 
Test User   888-555-1212   Director of Testing   Penthouse   Test 
First User     
Users       (Group)
  
3 object(s) found 


Query was executed in: 0.1640625 second(s)
Total Time (Execute, Enumeration and Rendering): 0.1953125 second(s)

If you click on an entry in the Name column, an additional page appears
with details about that entry.

How the Sample Works
====================
The Default.Asp file accepts the alias, first name, last name, group name,
or distribution list name and posts it to the Search.Asp file.

The Search.Asp file performs an ADO query and then enumerates the resulting
objects as the results of the search.

The Person.Asp and Group.Asp files provide details about a selected person
or group.