Métodos de propiedad IADsADSystemInfo

Los métodos de propiedad de la interfaz IADsADSystemInfo obtienen o establecen las propiedades descritas en la tabla siguiente. Para obtener más información, vea Interface Property Methods.

Propiedades

nombreDeEquipo

Recupera el nombre distintivo del equipo local.

Tipo de acceso: solo lectura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_ComputerName(
  [out] BSTR* pbstrComputer
);

DomainDNSName

Recupera el nombre DNS del dominio del equipo local, como "domainName.companyName.com".

Tipo de acceso: solo lectura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_DomainDNSName(
  [out] BSTR* pbstr
);

DomainShortName

Recupera el nombre corto del dominio del equipo local, como "domainName".

Tipo de acceso: solo lectura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_DomainShortName(
  [out] BSTR* pbstrDSN
);

ForestDNSName

Recupera el nombre DNS del bosque del equipo local.

Tipo de acceso: solo lectura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_ForestDNSName(
  [out] BSTR* pbstr
);

IsNativeMode

Determina si el dominio del equipo local está en modo nativo o mixto.

Tipo de acceso: solo lectura

Tipo de datos de scripting: BOOL

// C++ method syntax
HRESULT get_IsNativeMode(
  [out] BOOL* pvBool
);

PDCRoleOwner

Recupera el nombre distintivo del objeto del agente de servicio de directorio (DSA) para el controlador de dominio que posee el rol de controlador de dominio principal en el dominio del equipo local.

Tipo de acceso: solo lectura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_PDCRoleOwner(
  [out] BSTR* pbstr
);

SchemaRoleOwner

Recupera el nombre distintivo del objeto del agente de servicio de directorio (DSA) para el controlador de dominio que posee el rol maestro de esquema en el bosque del equipo local.

Tipo de acceso: solo lectura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_SchemaRoleOwner(
  [out] BSTR* pbstr
);

SiteName

Recupera el nombre del sitio del equipo local.

Tipo de acceso: solo lectura

Tipo de datos de scripting: BSTR

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

UserName

Recupera el nombre distintivo de Active Directory del usuario actual, que es el usuario que ha iniciado sesión o el usuario suplantado por el subproceso que realiza la llamada.

Tipo de acceso: solo lectura

Tipo de datos de scripting: BSTR

// C++ method syntax
HRESULT get_UserName(
  [out] BSTR* pbstrUser
);

Ejemplos

El siguiente ejemplo de código de C++ recupera la información del sistema de Windows. Por motivos de brevedad, se omite la comprobación de errores.

#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;
}

En el siguiente ejemplo de código de Visual Basic se recupera la información del sistema de 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

El siguiente ejemplo de código VBScript/ASP recupera la información del sistema de 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
%>

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Encabezado	Iads.h
Archivo DLL	Activeds.dll
IID	IID_IADsADSystemInfo se define como 5BB11929-AFD1-11D2-9CB9-0000F87A369E

Consulte también

IADsADSystemInfo

Cocreateinstance