Методы свойств IADsComputer

  • Статья

Методы интерфейса IADsComputer считывают и записывают свойства, описанные в этом разделе. Дополнительные сведения см. в разделе Методы свойств интерфейса.

Свойства

ComputerID

Глобальный уникальный идентификатор, назначенный каждому компьютеру.

Тип доступа: только для чтения

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_ComputerID(
  [out] BSTR* pbstrComputerID
);

Отдел

Подразделение, например отдел, к которому принадлежит этот компьютер.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Department(
  [out] BSTR* pbstrDepartment
);
HRESULT put_Department(
  [in] BSTR bstrDepartment
);

Описание

Описание этого компьютера.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Description(
  [out] BSTR* pbstrDescription
);
HRESULT put_Description(
  [in] BSTR bstrDescription
);

Отдел

Подразделение в организации, к которому принадлежит этот компьютер.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Division(
  [out] BSTR* pbstrDivision
);
HRESULT put_Division(
  [in] BSTR bstrDivision
);

Расположение

Назначенное физическое расположение этого компьютера.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Location(
  [out] BSTR* pbstrLocation
);
HRESULT put_Location(
  [in] BSTR bstrLocation
);

MemorySize

Размер (в мегабайтах) памяти произвольного доступа для этого компьютера.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_MemorySize(
  [out] BSTR* pbstrMemorySize
);
HRESULT put_MemorySize(
  [in] BSTR bstrMemorySize
);

Модель

Модель и модель этого компьютера.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Model(
  [out] BSTR* pbstrModel
);
HRESULT put_Model(
  [in] BSTR bstrModel
);

NetAddresses

Массив полей NetAddress, представляющих адреса, по которым можно связаться с этим компьютером. NetAddress — это зависят от поставщика BSTR , состоящие из двух подстрок, разделенных двоеточием (:). Левая подстрока указывает тип адреса, а правая подстрока представляет собой строковое представление адреса этого типа. Например, адреса TCP/IP имеют следующий вид: IP:100.201.301.45. Адреса типа IPX имеют следующий вид: IPX:10.123456.80.

Тип доступа: чтение и запись

Тип данных скрипта: VARIANT

// C++ method syntax
HRESULT get_NetAddresses(
  [out] VARIANT* pvNetAddresses
);
HRESULT put_NetAddresses(
  [in] VARIANT vNetAddresses
);

OperatingSystem

Операционная система, используемая на этом компьютере.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_OperatingSystem(
  [out] BSTR* pbstrOperatingSystem
);
HRESULT put_OperatingSystem(
  [in] BSTR bstrOperatingSystem
);

OperatingSystemVersion

Версия операционной системы, используемой на этом компьютере.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_OperatingSystemVersion(
  [out] BSTR* pbstrOperatingSystemVersion
);
HRESULT put_OperatingSystemVersion(
  [in] BSTR bstrOperatingSystemVersion
);

Владелец

Пользователь, которому назначен этот компьютер. Этот пользователь также должен иметь лицензию на запуск установленного программного обеспечения.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Owner(
  [out] BSTR* pbstrOwner
);
HRESULT put_Owner(
  [in] BSTR bstrOwner
);

PrimaryUser

Имя контактного лица, например администратора, для этого компьютера.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_PrimaryUser(
  [out] BSTR* pbstrPrimaryUser
);
HRESULT put_PrimaryUser(
  [in] BSTR bstrPrimaryUser
);

Процессор

Тип процессора.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Processor(
  [out] BSTR* pbstrProcessor
);
HRESULT put_Processor(
  [in] BSTR bstrProcessor
);

ProcessorCount

Количество установленных процессоров.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_ProcessorCount(
  [out] BSTR* pbstrProcessorCount
);
HRESULT put_ProcessorCount(
  [in] BSTR bstrProcessorCount
);

Роль

Роль этого компьютера, например рабочей станции, сервера или контроллера домена.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Role(
  [out] BSTR* pbstrRole
);
HRESULT put_Role(
  [in] BSTR bstrRole
);

Сайт

Глобальный уникальный идентификатор, определяющий сайт, на котором был установлен этот компьютер. Сайт — это физический регион с хорошим подключением в сети.

Тип доступа: только для чтения

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Site(
  [out] BSTR* pbstrSite
);

StorageCapacity

Размер диска в мегабайтах.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_StorageCapacity(
  [out] BSTR* pbstrStorageCapacity
);
HRESULT put_StorageCapacity(
  [in] BSTR bstrStorageCapacity
);

Комментарии

Разные поставщики могут предоставлять различные свойства объекта-компьютера. Дополнительные сведения см. в разделе Поставщики системы ADSI.

Вы можете узнать, какие свойства поддерживаются, проверив обязательные и необязательные свойства с помощью класса схемы. Дополнительные сведения см. в интерфейсе IADsClass .

Чтобы проверить состояние компьютера или выполнить операцию завершения работы по сети, необходимо использовать интерфейс IADsComputerOperations .

Примеры

В следующем примере кода Visual Basic проверяются свойства компьютера, поддерживаемые поставщиком ADSI WinNT.

Dim obj As IADs
On Error Resume Next

Set obj = GetObject("WinNT://myMachine,computer")
If (obj.Class = "Computer") Then
    MsgBox "Computer owner: " & obj.owner
    MsgBox "Computer division: " & obj.Division
    MsgBox "Computer operatingSystem: " & obj.OperatingSystem
    MsgBox "Computer operating System Version: " & obj.OperatingSystemVersion
    MsgBox "Computer processor: " & obj.Processor
    MsgBox "Computer processor Count: " & obj.ProcessorCount
End If

В следующем примере кода C++ проверяются свойства компьютера, поддерживаемые поставщиком WINNT ADSI.

IADsComputer *pComp = NULL;
LPWSTR adspath = L"WinNT://jeffsmith1,computer";
HRESULT hr = S_OK;
BSTR bstr = NULL;

hr = ADsGetObject(adspath,IID_IADsComputer,(void**)&pComp);
if(FAILED(hr)) {goto Cleanup;}

hr = pComp->get_Owner(&bstr);
if(FAILED(hr)) {goto Cleanup;}

printf("Computer owner: %S\n",bstr);
SysFreeString(bstr);

hr = pComp->get_OperatingSystem(&bstr);
if(FAILED(hr)) {goto Cleanup;}
printf("Operating System: %S\n",bstr);
SysFreeString(bstr);

Cleanup:
    if(pComp) pComp->Release();
    if(bstr) SysFreeString(bstr);
    return hr;

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista
Минимальная версия сервера
 Windows Server 2008
Заголовок
Iads.h
DLL
Activeds.dll
IID
 IID_IADsComputer определяется как EFE3CC70-1D9F-11CF-B1F3-02608C9E7553

См. также раздел

IADsComputer

Поставщики системы ADSI

IADsClass

IADsComputerOperations

Методы свойств интерфейса