96 lines
2.8 KiB
Plaintext
96 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.
|
|
//
|
|
// WkGuid VC Sample: Using Well-Known GUIDs
|
|
//
|
|
//--------------------------------------------------------------------------
|
|
|
|
Description
|
|
===========
|
|
The WkGuid sample uses the well-known GUID of the Users container to bind
|
|
to the Users container in the default naming context.
|
|
|
|
This sample uses the LDAP: provider and is suitable for Windows 2000 and
|
|
later networks running Active Directory.
|
|
|
|
Sample Files
|
|
============
|
|
* UsersContainer.sln
|
|
* UsersContainer.vcproj
|
|
* WkGuid.cpp
|
|
* makefile
|
|
* readme.txt
|
|
|
|
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 UsersContainer.sln.
|
|
2. 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 "UsersContainer.exe".
|
|
|
|
You can also run the sample by selecting Execute UsersContainer.exe from
|
|
the Build menu.
|
|
|
|
Example Output
|
|
==============
|
|
Running the sample produces the following output when run in the Fabrikam.Com
|
|
domain.
|
|
|
|
This program finds the User's container in the current Window 2000 domain
|
|
It uses the WKGUID binding string format.
|
|
|
|
ADsPath of Users Container (using WKGUID binding format):
|
|
LDAP://<WKGUID=a9d1ca15768811d1aded00c04fd8d5cd,DC=fabrikam,DC=com>
|
|
|
|
Name of Users Container (using WKGUID binding format):
|
|
<WKGUID=a9d1ca15768811d1aded00c04fd8d5cd,DC=fabrikam,DC=com>
|
|
|
|
Name of Users Container: CN=Users,DC=fabrikam,DC=com
|
|
|
|
How the Sample Works
|
|
====================
|
|
The sample defines two functions.
|
|
|
|
wmain
|
|
Initializes, calls the GetWKDomainObject function, and prints
|
|
out the ADsPath, name in WKGUID format, and common name of the
|
|
Users container.
|
|
GetWKDomainObject
|
|
Gets the specified well-know object for the current domain.
|
|
|
|
You can also use well-known GUIDs to bind to other well-known containers,
|
|
such as the Computers container. The complete list includes:
|
|
|
|
* GUID_USERS_CONTAINER_W
|
|
* GUID_COMPUTRS_CONTAINER_W
|
|
* GUID_SYSTEMS_CONTAINER_W
|
|
* GUID_DOMAIN_CONTROLLERS_CONTAINER_W
|
|
* GUID_INFRASTRUCTURE_CONTAINER_W
|
|
* GUID_DELETED_OBJECTS_CONTAINER_W
|
|
* GUID_LOSTANDFOUND_CONTAINER_W
|
|
|
|
See Also
|
|
========
|
|
IADs interface
|
|
Binding to Well-Known Objects Using WKGUID
|
|
|