IADsADSystemInfo::GetDCSiteName メソッド (iads.h)

IADsADSystemInfo::GetDCSiteName メソッドは、ローカル コンピューターを含む Active Directory サイトの名前を取得します。

構文

HRESULT GetDCSiteName(
  [out] BSTR szServer,
  [in]  BSTR *pszSiteName
);

パラメーター

[out] szServer

Active Directory サイトの名前。

[in] pszSiteName

サービス サーバーの DNS 名。

戻り値

このメソッドは、標準の HRESULT 戻り値をサポートしています。 詳細については、「 ADSI エラー コード」を参照してください。

注釈

Active Directory サイトは、Active Directory ドメイン コントローラーを保持する 1 つ以上の適切に接続された TCP/IP サブネットです。 詳細については、「 Active Directory Core の概念」を参照してください。

例

次の C++ コード例では、Active Directory サイト名を取得します。 簡潔にするために、エラー チェックは省略されます。

#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 siteName;
   BSTR dnsServer;
   hr = pSys->GetAnyDCName(&dnsServer);

   if (SUCCEEDED(hr)) {
      printf("Domain controller: %S\n", dnsServer);

      hr = pSys->GetDCSiteName(&siteName);
      if (SUCCEEDED(hr)) {
          printf("Domain controller site: %S\n", siteName);
          SysFreeString(siteName);
      }

      SysFreeString(dnsServer);
   }

 
   if(pSys) {
      pSys->Release();
   }
 
   CoUninitialize();
   return 0;
}

次の Visual Basic コード例では、Active Directory ドメイン コントローラー サイトの名前を取得します。

Dim sys As New ADSystemInfo
dc = sys.GetAnyDCName
Debug.Print "Domain Controller site: " & sys.GetDCSiteName(dc)

次の VBScript/ASP コード例では、Active Directory ドメイン コントローラー サイトの名前を取得します。

<%
Dim sys

Set sys = CreateObject("ADSystemInfo")

dc = sys.GetAnyDCName

wscript.echo "Domain Controller     : " & dc
wscript.echo "Domain Controller site: " & sys.GetDCSiteName(dc)

%>

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	iads.h
[DLL]	Activeds.dll

こちらもご覧ください

ADSI エラー コード

Active Directory のコア概念

IADsADSystemInfo