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
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
