Compartilhar via

Métodos da propriedade IADsComputer

  • Artigo

Os métodos de interface IADsComputer leem e gravam as propriedades descritas neste tópico. Para obter mais informações, consulte Métodos de propriedade de interface.

Propriedades

ComputerID

O identificador global exclusivo atribuído a cada computador.

Tipo de acesso: Somente leitura

Tipo de dados de script: BSTR

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

Departamento

A UO (unidade organizacional), como o departamento, à qual este computador pertence.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Descrição

A descrição deste computador.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Divisão

A divisão, dentro de uma organização, à qual este computador pertence.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Localidade

O local físico atribuído deste computador.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

MemorySize

O tamanho, em megabytes, da memória de acesso aleatório para este computador.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Modelo

A criação e o modelo deste computador.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

NetAddresses

Uma matriz de campos NetAddress que representam os endereços pelos quais este computador pode ser acessado. NetAddress é um BSTR específico do provedor composto por duas subcadeias de caracteres separadas por dois-pontos (:). A subcadeia de caracteres esquerda indica o tipo de endereço e a subcadeia de caracteres direita é uma representação de cadeia de caracteres de um endereço desse tipo. Por exemplo, endereços TCP/IP são do formato: IP:100.201.301.45. Os endereços de tipo IPX são do formato: IPX:10.123456.80.

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

OperatingSystem

O sistema operacional usado neste computador.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

OperatingSystemVersion

A versão do sistema operacional usada neste computador.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Proprietário

A pessoa à qual este computador é atribuído. Essa pessoa também deve ter uma licença para executar o software instalado.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

PrimaryUser

O nome da pessoa de contato, como um administrador, para este computador.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Processador

O tipo de processador.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

ProcessorCount

O número de processadores instalados.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Função

A função deste computador, por exemplo, estação de trabalho, servidor ou controlador de domínio.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Site

O identificador global exclusivo que identifica o site no qual este computador foi instalado. Um site é uma região física de boa conectividade em uma rede.

Tipo de acesso: Somente leitura

Tipo de dados de script: BSTR

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

StorageCapacity

O tamanho, em megabytes, do disco.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

Comentários

Provedores diferentes podem optar por expor propriedades diferentes de um objeto de computador. Para obter mais informações, consulte Provedores de sistema ADSI.

Você pode descobrir quais propriedades têm suporte inspecionando as propriedades obrigatórias e opcionais por meio de sua classe de esquema. Para obter mais informações, consulte a interface IADsClass .

Para examinar a status de um computador ou executar a operação de desligamento em toda a rede, você deve usar a interface IADsComputerOperations.

Exemplos

O exemplo de código do Visual Basic a seguir examina as propriedades do computador compatíveis com o provedor 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

O exemplo de código C++ a seguir examina as propriedades do computador compatíveis com o provedor 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;

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Cabeçalho
Iads.h
DLL
Activeds.dll
IID
 IID_IADsComputer é definido como EFE3CC70-1D9F-11CF-B1F3-02608C9E7553

Confira também

IADsComputer

Provedores de sistema ADSI

IADsClass

IADsComputerOperations

Métodos de propriedade de interface