IADsWinNTSystemInfo Property Methods

The property methods of the IADsWinNTSystemInfo interface get or set the properties described in the following table. For more information, see Interface Property Methods.

Properties

ComputerName

Name of the host computer where the application is running.

Access type: Read-only

Scripting data type: BSTR

// C++ method syntax
HRESULT get_ComputerName(
  [out] BSTR* pbstrComputer
);

DomainName

Name of the domain to which the user belongs.

Access type: Read-only

Scripting data type: BSTR

// C++ method syntax
HRESULT get_DomainName(
  [out] BSTR* pbstrDomain
);

PDC

Name of the primary domain controller to which the host computer belongs.

Access type: Read-only

Scripting data type: BSTR

// C++ method syntax
HRESULT get_PDC(
  [out] BSTR* pbstrPDC
);

UserName

Name of the user account under which the WinNTSystemInfo object is created.

Access type: Read-only

Scripting data type: BSTR

// C++ method syntax
HRESULT get_UserName(
  [out] BSTR* pbstrUser
);

Examples

The following C/C++ code example retrieves the WinNT system information. For brevity, error checking is omitted.

#include <activeds.h>
#include <stdio.h>
 
int main()
{
   HRESULT hr;
 
   hr = CoInitialize(NULL);
 
    IADsWinNTSystemInfo *pNtSys;
    hr = CoCreateInstance(CLSID_WinNTSystemInfo,
                          NULL,
                          CLSCTX_INPROC_SERVER,
                          IID_IADsWinNTSystemInfo,
                          (void**)&pNTsys);
 
   BSTR bstr;
   hr = pNtSys->get_UserName(&bstr);
   if (SUCCEEDED(hr)) {
      printf("User: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   hr = pNtSys->get_ComputerName(&bstr);
   if (SUCCEEDED(hr)) {
      printf("Computer: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   hr = pNtSys->get_DomainName(&bstr);
   if (SUCCEEDED(hr)) {
      printf("Domain: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   hr = pNtSys->get_PDC(&bstr);
   if (SUCCEEDED(hr)) {
      printf("PDC: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   if(pNtSys) {
      pNtSys->Release();
   }
 
   CoUninitialize();
   return 0;
}

The following Visual Basic code example retrieves the WinNT system information.

Dim ntsys As New WinNTSystemInfo
Debug.print "User: " & ntsys.UserName
Debug.print "Computer: " & ntsys.ComputerName
Debug.print "Domain: " & ntsys.DomainName
Debug.print "PDC: " & ntsys.PDC

The following Visual Basic Scripting Edition/Active Server Pages code example retrieves the WinNT system information.

<%
Dim ntsys
Set ntsys = CreateObject("WinNTSystemInfo")
Response.Write "User: " & ntsys.UserName
Response.Write "Computer: " & ntsys.ComputerName
Response.Write "Domain: " & ntsys.DomainName
Response.Write "PDC: " & ntsys.PDC
%>

Requirements

Requirement Value
Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Header
Iads.h
DLL
Activeds.dll
IID
IID_IADsWinNTSystemInfo is defined as 6C6D65DC-AFD1-11D2-9CB9-0000F87A369E

See also

IADsWinNTSystemInfo