NetDfsRemoveFtRootForced 関数 (lmdfs.h)
ルート ターゲット サーバーがオフラインの場合でも、ドメイン ベースの分散ファイル システム (DFS) 名前空間から指定されたルート ターゲットを削除します。 DFS 名前空間の最後のルート ターゲットが削除されている場合、関数は DFS 名前空間も削除します。 DFS 名前空間は、その中のすべてのリンクを最初に削除せずに削除できます。
構文
NET_API_STATUS NET_API_FUNCTION NetDfsRemoveFtRootForced(
[in] LPWSTR DomainName,
[in] LPWSTR ServerName,
[in] LPWSTR RootShare,
[in] LPWSTR FtDfsName,
DWORD Flags
);
パラメーター
[in] DomainName
削除するドメイン ベースの DFS 名前空間を含む Active Directory ドメインの名前を指定する文字列へのポインター。 このパラメーターは必須です。
[in] ServerName
削除する DFS ルート ターゲット サーバーの名前を指定する文字列へのポインター。 サーバーは、ドメイン ベースの DFS 名前空間のルートをホストする必要があります。 このパラメーターは必須です。
[in] RootShare
削除する DFS ルート ターゲット共有の名前を指定する文字列へのポインター。 このパラメーターは必須です。
[in] FtDfsName
ルート ターゲットを削除するドメイン ベースの DFS 名前空間の名前を指定する文字列へのポインター。 このパラメーターは必須です。 通常、これは RootShare パラメーターと同じです。
Flags
ゼロを指定してください。
戻り値
関数が成功した場合、戻り値は NERR_Success。
関数が失敗した場合、戻り値はシステム エラー コードです。 エラー コードの一覧については、「 システム エラー コード」を参照してください。
注釈
呼び出し元には、ディレクトリ サービス内の DFS コンテナーを更新するためのアクセス許可が必要であり、DFS ホスト (ルート) サーバーに対する管理者特権が必要です。
NetDfsRemoveFtRootForced 関数は、ドメイン ベースの DFS ルート ターゲットを DFS 名前空間から強制的に削除します。 名前空間のルート ターゲット サーバーが使用できなくなった場合 (使用停止になったなど) に、ドメインベースの DFS 名前空間を削除するために使用されます。
DFS ルート ターゲットは、プライマリ ドメイン コントローラー (PDC) に接続し、DFS ルート ターゲット サーバーを削除することによって削除されないため、 NetDfsRemoveFtRootForced はルート ターゲット サーバーのレジストリを更新しません。 通常の状況では、 NetDfsRemoveFtRoot 関数を呼び出すことで、DFS ドメイン ルートからルート ターゲットを削除できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | lmdfs.h (LmDfs.h、Lm.h を含む) |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |