108 lines
2.8 KiB
Plaintext
108 lines
2.8 KiB
Plaintext
//+-------------------------------------------------------------------------
|
|
//
|
|
// 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.
|
|
//
|
|
// Search VC Sample: Searching Active Directory
|
|
//
|
|
//--------------------------------------------------------------------------
|
|
|
|
Description
|
|
===========
|
|
The Search sample uses the IDirectorySearch interface to search Active
|
|
Directory for objects that match a specified filter.
|
|
|
|
This sample uses the LDAP: provider and is suitable for Windows 2000 and
|
|
later networks running Active Directory.
|
|
|
|
Sample Files
|
|
============
|
|
* makefile
|
|
* Search.cpp
|
|
* Search.sln
|
|
* Search.vcproj
|
|
* StdAfx.cpp
|
|
* StdAfx.h
|
|
|
|
Building the Sample
|
|
===================
|
|
When you build this sample using Visual Studio, be sure that you have the
|
|
INCLUDE directory for the Platform SDK set first in the Options list of
|
|
include files.
|
|
|
|
To build this sample
|
|
1. Open the solution Search.sln.
|
|
2. Open the source file Search.Cpp.
|
|
3. Replace the domain name with an existing one, such as "DC=Fabrikam,
|
|
DC=Com" in the following line.
|
|
hr = ADsGetObject(L"LDAP://DC=testDom1,DC=testDom2, \
|
|
DC=microsoft,DC=com", \
|
|
IID_IDirectorySearch, \
|
|
(void**) &pSearch );
|
|
4. From the Build menu, select Build.
|
|
|
|
You can also build this sample at a command prompt using the supplied
|
|
makefile.
|
|
|
|
Running the Sample
|
|
==================
|
|
To run this sample
|
|
1. Open a command prompt and change to the directory where you built
|
|
the sample.
|
|
2. Type the command "Search.exe".
|
|
|
|
You can also run the sample by selecting Execute Search.exe from
|
|
the Build menu.
|
|
|
|
Example Output
|
|
==============
|
|
If the sample executes successfully, it prints output similar to the following
|
|
in a command window.
|
|
|
|
HelpServicesGroup
|
|
Administrators
|
|
Users
|
|
Guests
|
|
Print Operators
|
|
Backup Operators
|
|
Replicator
|
|
Remote Desktop Users
|
|
Network Configuration Operators
|
|
Domain Computers
|
|
Domain Controllers
|
|
Schema Admins
|
|
Enterprise Admins
|
|
Cert Publishers
|
|
Domain Admins
|
|
Domain Users
|
|
Domain Guests
|
|
Group Policy Creator Owners
|
|
RAS and IAS Servers
|
|
Server Operators
|
|
Account Operators
|
|
Pre-Windows 2000 Compatible Access
|
|
Incoming Forest Trust Builders
|
|
DnsAdmins
|
|
DnsUpdateProxy
|
|
DHCP Users
|
|
DHCP Administrators
|
|
Win2K Group Name
|
|
My New Group
|
|
|
|
How the Sample Works
|
|
====================
|
|
The sample uses the LDAP: ADsPath to perform the bindings and the
|
|
IDirectorySearch interface to perform the search with the LDAP
|
|
syntax filter "(objectCategory=Group).
|
|
|
|
See Also
|
|
========
|
|
IDirectorySearch interface
|
|
LDAP ADsPath
|
|
LDAP Binding String (ADsPath)
|
|
|