IADsComputer 属性方法

  • 项目

IADsComputer 接口方法读取和写入本主题中所述的属性。 有关详细信息，请参阅 Interface 属性方法。

属性

ComputerID

分配给每台计算机的全局唯一标识符。

访问类型：只读

脚本数据类型： BSTR

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

Department

此计算机所属的组织单位（OU），例如部门。

访问类型：读/写

脚本数据类型： 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
);

存储Capacity

磁盘的大小（以兆字节为单位）。

访问类型：读/写

脚本数据类型： 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++ 代码示例检查 ADSI WinNT 提供程序支持的计算机属性。

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

Interface 属性方法