Методы свойств IADsADSystemInfo
Методы свойств интерфейса IADsADSystemInfo получают или задают свойства, описанные в следующей таблице. Дополнительные сведения см. в разделе Методы свойств интерфейса.
Свойства
-
ИмяКомпьютера
-
-
Тип доступа: только для чтения
-
Тип данных скрипта: BSTR
-
// C++ method syntax HRESULT get_ComputerName( [out] BSTR* pbstrComputer );
Извлекает различающееся имя локального компьютера.
-
-
DomainDNSName
-
-
Тип доступа: только для чтения
-
Тип данных скрипта: BSTR
-
// C++ method syntax HRESULT get_DomainDNSName( [out] BSTR* pbstr );
Извлекает DNS-имя домена локального компьютера, например "domainName.companyName.com".
-
-
DomainShortName
-
-
Тип доступа: только для чтения
-
Тип данных скрипта: BSTR
-
// C++ method syntax HRESULT get_DomainShortName( [out] BSTR* pbstrDSN );
Извлекает короткое имя домена локального компьютера, например domainName.
-
-
ForestDNSName
-
-
Тип доступа: только для чтения
-
Тип данных скрипта: BSTR
-
// C++ method syntax HRESULT get_ForestDNSName( [out] BSTR* pbstr );
Извлекает DNS-имя леса локального компьютера.
-
-
IsNativeMode
-
-
Тип доступа: только для чтения
-
Тип данных скрипта: BOOL
-
// C++ method syntax HRESULT get_IsNativeMode( [out] BOOL* pvBool );
Определяет, находится ли домен локального компьютера в собственном или смешанном режиме.
-
-
PDCRoleOwner
-
-
Тип доступа: только для чтения
-
Тип данных скрипта: BSTR
-
// C++ method syntax HRESULT get_PDCRoleOwner( [out] BSTR* pbstr );
Извлекает различающееся имя объекта агента службы каталогов (DSA) для контроллера домена, которому принадлежит роль основного контроллера домена в домене локального компьютера.
-
-
SchemaRoleOwner
-
-
Тип доступа: только для чтения
-
Тип данных скрипта: BSTR
-
// C++ method syntax HRESULT get_SchemaRoleOwner( [out] BSTR* pbstr );
Извлекает различающееся имя объекта агента службы каталогов (DSA) для контроллера домена, которому принадлежит роль master схемы в лесу локального компьютера.
-
-
Sitename
-
-
Тип доступа: только для чтения
-
Тип данных скрипта: BSTR
-
// C++ method syntax HRESULT get_SiteName( [out] BSTR* pbstrSite );
Извлекает имя сайта локального компьютера.
-
-
UserName
-
-
Тип доступа: только для чтения
-
Тип данных скрипта: BSTR
-
// C++ method syntax HRESULT get_UserName( [out] BSTR* pbstrUser );
Извлекает различающееся имя текущего пользователя Active Directory, которое является вошедшего в систему пользователя или пользователя, олицетворенного вызывающим потоком.
-
Примеры
В следующем примере кода C++ извлекаются сведения о системе Windows. Для краткости проверка ошибок опущена.
#include <activeds.h>
#include <stdio.h>
int main()
{
HRESULT hr;
hr = CoInitialize(NULL);
IADsADSystemInfo *pSys;
hr = CoCreateInstance(CLSID_ADSystemInfo,
NULL,
CLSCTX_INPROC_SERVER,
IID_IADsADSystemInfo,
(void**)&pSys);
BSTR bstr;
hr = pSys->get_UserName(&bstr);
if (SUCCEEDED(hr)) {
printf("User: %S\n", bstr);
SysFreeString(bstr);
}
hr = pSys->get_ComputerName(&bstr);
if (SUCCEEDED(hr)) {
printf("Computer: %S\n", bstr);
SysFreeString(bstr);
}
hr = pSys->get_DomainDNSName(&bstr);
if (SUCCEEDED(hr)) {
printf("Domain: %S\n", bstr);
SysFreeString(bstr);
}
hr = pSys->get_PDCRoleOwner(&bstr);
if (SUCCEEDED(hr)) {
printf("PDC Role owner: %S\n", bstr);
SysFreeString(bstr);
}
if(pSys) {
pSys->Release();
}
CoUninitialize();
return 0;
}
В следующем примере кода Visual Basic извлекаются сведения о системе Windows.
Dim sys As New ADSystemInfo
Debug.print "User: " & sys.UserName
Debug.print "Computer: " & sys.ComputerName
Debug.print "Domain: " & sys.DomainDNSName
Debug.print "PDC Role Owner: " & sys.PDCRoleOwner
В следующем примере кода VBScript/ASP извлекаются сведения о системе Windows.
<%
Dim sys
Set sys = CreateObject("ADSystemInfo")
Response.Write "User: " & sys.UserName
Response.Write "Computer: " & sys.ComputerName
Response.Write "Domain: " & sys.DomainDNSName
Response.Write "PDC Role Owner: " & sys.PDCRoleOwner
%>
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows Vista |
Минимальная версия сервера |
Windows Server 2008 |
Заголовок |
|
DLL |
|
IID |
IID_IADsADSystemInfo определяется как 5BB11929-AFD1-11D2-9CB9-0000F87A369E |