Q200126: HOWTO: Determining the Domain of A User Through ADSI

Article: Q200126
Product(s): Microsoft Windows NT
Version(s): winnt:2.0,2.5,4.0
Operating System(s): 
Keyword(s): kbADSI kbGrpDSPlatform kbDSupport
Last Modified: 04-OCT-1999

-------------------------------------------------------------------------------
The information in this article applies to:

- Microsoft Windows NT Workstation version 4.0 
- Microsoft Active Directory Service Interfaces, versions 2.0, 2.5 
-------------------------------------------------------------------------------

SUMMARY
=======

The Active Directory Services Interface (ADSI) is the preferred method for
working with Microsoft Windows NT user accounts. However, there may be times
when the Windows NT provider in ADSI does not highlight a method or property
needed for a specific task. In that case, determine the domain and name of the
user being referenced by an ADsPath, so that other calls can be made.

NOTE: This method only applies to Windows NT 3.0 or 4.0 domains.

MORE INFORMATION
================

To determine the domain of a user given its ADsPath complete the following
steps:

1. Get the user object.

2. Get the ADsPath of the object's parent.

3. Verify the parent's class is "Domain".

4. Get the name of the parent object.

Sample Code
-----------

     /*++

     ATL is used to simplify the COM interface usage

     assert()'s are used instead of real error checking
     for readability.

     Build command line:<BR/>

         cl main.cpp adsiid.lib activeds.lib

     --*/ 

     #define UNICODE
     #define _UNICODE
     #include <windows.h>
     #include <activeds.h>
     #include <atlbase.h>
     #include <stdio.h>
     #include <assert.h>
     #include <atlimpl.cpp>

     #define RTN_OK      0
     #define RTN_USAGE   1
     #define RTN_ERROR   13

     extern "C" int wmain (int argc, wchar_t *argv[])
     {

         DWORD dwRes;
         CComPtr<IADsUser> pUser;
         CComPtr<IADs> pObject;
         CComBSTR strDomainPath, strUser, strDomain;
         CComBSTR strClass;
         HRESULT hr;

         // initialize COM
         // 
         hr = CoInitialize (NULL);
         assert (SUCCEEDED(hr));

         // check command line
         // 
         if (argc != 2) {
             printf ("Usage: %S <ADS path to domain user>\n", argv[0]);
             return (RTN_USAGE);
         }

         // get the user object
         // 
         hr = ADsGetObject (
                     argv[1],
                     IID_IADsUser,
                     reinterpret_cast<void**>(&pUser)
                     );
         assert (SUCCEEDED(hr));

         // get the user name
         // 
         hr = pUser->get_Name (&strUser);
         assert (SUCCEEDED(hr));

         // get the parent of the object
         // 
         hr = pUser->get_Parent (&strDomainPath);
         assert (SUCCEEDED (hr));

         hr = ADsGetObject (
                     strDomainPath,
                     IID_IADs,
                     reinterpret_cast<void**>(&pObject)
                     );
         assert (SUCCEEDED(hr));

         // verify that it's a domain - this could have been done by
         // getting an IADsDomain interface in the ADsGetObject call...
         // 
         hr = pObject->get_Class (&strClass);
         assert (SUCCEEDED(hr));

         assert (!wcscmp (TEXT("Domain"), strClass));

         // get the domain name
         // 
         hr = pObject->get_Name (&strDomain);
         assert (SUCCEEDED(hr));

         printf ("Domain of user %S is %S\n", strUser, strDomain);

         return (RTN_OK);
     }

Additional query words:

======================================================================
Keywords          : kbADSI kbGrpDSPlatform kbDSupport 
Technology        : kbWinNTsearch kbWinNTWsearch kbWinNTW400 kbWinNTW400search kbWinNT400xsearch kbAudDeveloper kbADSISearch kbADSI200 kbADSI250
Version           : winnt:2.0,2.5,4.0
Issue type        : kbhowto

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 1986-2002.