Metodi della proprietà IADsADSystemInfo
I metodi di proprietà dell'interfaccia IADsADSystemInfo ottengono o impostano le proprietà descritte nella tabella seguente. Per altre informazioni, vedere Metodi di proprietà dell'interfaccia.
Proprietà
-
NomeComputer
-
-
Tipo di accesso: sola lettura
-
Tipo di dati scripting: BSTR
-
// C++ method syntax HRESULT get_ComputerName( [out] BSTR* pbstrComputer );
Recupera il nome distinto del computer locale.
-
-
DomainDNSName
-
-
Tipo di accesso: sola lettura
-
Tipo di dati scripting: BSTR
-
// C++ method syntax HRESULT get_DomainDNSName( [out] BSTR* pbstr );
Recupera il nome DNS del dominio del computer locale, ad esempio "domainName.companyName.com".
-
-
DomainShortName
-
-
Tipo di accesso: sola lettura
-
Tipo di dati scripting: BSTR
-
// C++ method syntax HRESULT get_DomainShortName( [out] BSTR* pbstrDSN );
Recupera il nome breve del dominio del computer locale, ad esempio "domainName".
-
-
ForestDNSName
-
-
Tipo di accesso: sola lettura
-
Tipo di dati scripting: BSTR
-
// C++ method syntax HRESULT get_ForestDNSName( [out] BSTR* pbstr );
Recupera il nome DNS della foresta del computer locale.
-
-
IsNativeMode
-
-
Tipo di accesso: sola lettura
-
Tipo di dati scripting: BOOL
-
// C++ method syntax HRESULT get_IsNativeMode( [out] BOOL* pvBool );
Determina se il dominio del computer locale è in modalità nativa o mista.
-
-
PDCRoleOwner
-
-
Tipo di accesso: sola lettura
-
Tipo di dati scripting: BSTR
-
// C++ method syntax HRESULT get_PDCRoleOwner( [out] BSTR* pbstr );
Recupera il nome distinto dell'oggetto agente del servizio directory (DSA) per il controller di dominio proprietario del ruolo del controller di dominio primario nel dominio del computer locale.
-
-
SchemaRoleOwner
-
-
Tipo di accesso: sola lettura
-
Tipo di dati scripting: BSTR
-
// C++ method syntax HRESULT get_SchemaRoleOwner( [out] BSTR* pbstr );
Recupera il nome distinto dell'oggetto agente del servizio directory (DSA) per il controller di dominio proprietario del ruolo master dello schema nella foresta del computer locale.
-
-
SiteName
-
-
Tipo di accesso: sola lettura
-
Tipo di dati scripting: BSTR
-
// C++ method syntax HRESULT get_SiteName( [out] BSTR* pbstrSite );
Recupera il nome del sito del computer locale.
-
-
UserName
-
-
Tipo di accesso: sola lettura
-
Tipo di dati scripting: BSTR
-
// C++ method syntax HRESULT get_UserName( [out] BSTR* pbstrUser );
Recupera il nome distinto di Active Directory dell'utente corrente, ovvero l'utente connesso o l'utente rappresentato dal thread chiamante.
-
Esempio
Nell'esempio di codice C++ seguente vengono recuperate le informazioni di sistema di Windows. Per brevità, il controllo degli errori viene omesso.
#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;
}
Nell'esempio di codice di Visual Basic seguente vengono recuperate le informazioni di sistema di 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
Nell'esempio di codice VBScript/ASP seguente vengono recuperate le informazioni di sistema di 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
%>
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato |
Windows Vista |
Server minimo supportato |
Windows Server 2008 |
Intestazione |
|
DLL |
|
IID |
IID_IADsADSystemInfo è definito come 5BB11929-AFD1-11D2-9CB9-0000F87A369E |