DsIsNTDSOnline 関数

[この機能は、「要件」セクションで指定されているオペレーティング システムで使用できます。 以降のバージョンでは、変更または使用できない場合があります。 Windows Vista 以降では、代わりに ボリューム シャドウ コピー サービス (VSS) を使用します。

DsIsNTDSOnline 関数は、指定したサーバー上で Active Directory ドメイン サービスがオンラインであるかどうかを判断します。

構文

HRESULT DsIsNTDSOnline(
  _In_  LPCTSTR szServerName,
  _Out_ BOOL    *pfNTDSOnline
);

パラメーター

szServerName (英語)[in]

テストするサーバーの名前を含む null で終わる文字列へのポインター。 先行するバックスラッシュはオプションです。 サーバーは、この関数が呼び出されたコンピューターと同じである必要があります。 サーバー名にアンダースコア (_) 文字を含めることはできません。 サーバー名の例としては、"\\server1" があります。

pfNTDSオンライン[out]

結果を受け取る BOOL 値へのポインター。 ディレクトリ サービスがオンラインの場合は TRUE を受け取り、ディレクトリ サービスがオフラインの場合は FALSE を受け取ります。

戻り値

関数が成功した場合は S_OK を返し、成功した場合はエラー コードを返します。 次のリストは、考えられるエラーコードの一覧です。

ERROR_ACCESS_DENIED

呼び出し元には、この関数を呼び出すための適切なアクセス権限がありません。 DsSetAuthIdentity 関数を使用して、バックアップ機能と復元機能に使用する資格情報を設定できます。

hrCouldNotConnect を する

szServerName のサーバーが見つからないか、ドメイン コントローラーではないか、szServerName の形式が正しくありません。 この値は Ntdsbmsg.h で定義されています。

RPC_S_INVALID_BINDING

DsIsNTDSOnline 関数がリモートで呼び出されているか、szServerName のサーバーがドメイン コントローラーではありません。

注釈

ディレクトリのバックアップ関数または復元関数を呼び出す前に、この関数を呼び出します。 バックアップを実行するには、ディレクトリがオンラインである必要があります。 ディレクトリは、復元を実行するにはオフラインにする必要があります。

この関数は、 szServerName で指定されたターゲット サーバーでもあるドメイン コントローラーからのみ呼び出すことができます。 この関数はリモートで呼び出すことはできません。

要求事項

こちらも参照ください

DsSetAuthIdentity

ディレクトリ バックアップ関数の

Active Directory サーバーのバックアップと復元