IADsADSystemInfo 속성 메서드

IADsADSystemInfo 인터페이스의 속성 메서드는 다음 표에 설명된 속성을 얻거나 설정합니다. 자세한 내용은 Interface 속성 메서드를 참조하세요.

속성

컴퓨터 이름

로컬 컴퓨터의 고유 이름을 검색합니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: BSTR

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

DomainDNSName

로컬 컴퓨터 도메인의 DNS 이름(예: "domainName.companyName.com")을 검색합니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: BSTR

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

DomainShortName

로컬 컴퓨터 도메인의 짧은 이름(예: "domainName")을 검색합니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: BSTR

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

ForestDNSName

로컬 컴퓨터 포리스트의 DNS 이름을 검색합니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: BSTR

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

IsNativeMode

로컬 컴퓨터의 도메인이 네이티브 모드인지 혼합 모드인지 확인합니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: BOOL

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

PDCRoleOwner

로컬 컴퓨터의 도메인에서 기본 도메인 컨트롤러 역할을 소유하는 DC에 대한 DSA(디렉터리 서비스 에이전트) 개체의 고유 이름을 검색합니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: BSTR

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

SchemaRoleOwner

로컬 컴퓨터의 포리스트에서 스키마 master 역할을 소유하는 DC에 대한 DSA(디렉터리 서비스 에이전트) 개체의 고유 이름을 검색합니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: BSTR

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

SiteName

로컬 컴퓨터의 사이트 이름을 검색합니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: BSTR

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

UserName

현재 사용자의 Active Directory 고유 이름(로그온한 사용자 또는 호출 스레드에서 가장한 사용자)을 검색합니다.

액세스 형식: 읽기 전용

스크립팅 데이터 형식: BSTR

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

예제

다음 C++ 코드 예제에서는 Windows 시스템 정보를 검색합니다. 간단히 하기 위해 오류 검사는 생략됩니다.

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

다음 Visual Basic 코드 예제에서는 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

다음 VBScript/ASP 코드 예제는 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
%>

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
헤더	Iads.h
DLL	Activeds.dll
IID	IID_IADsADSystemInfo 5BB11929-AFD1-11D2-9CB9-0000F87A369E로 정의됩니다.

추가 정보

IADsADSystemInfo

CoCreateInstance