NetDfsAddFtRoot 関数 (lmdfs.h)
新しいドメイン ベースの分散ファイル システム (DFS) 名前空間を作成します。 名前空間が既に存在する場合、関数は指定されたルート ターゲットを追加します。
構文
NET_API_STATUS NET_API_FUNCTION NetDfsAddFtRoot(
[in] LPWSTR ServerName,
[in] LPWSTR RootShare,
[in] LPWSTR FtDfsName,
[in, optional] LPWSTR Comment,
[in] DWORD Flags
);
パラメーター
[in] ServerName
新しい DFS ルート ターゲットをホストするサーバーの名前を指定する文字列へのポインター。 この値を IP アドレスにすることはできません。 このパラメーターは必須です。
[in] RootShare
新しい DFS ルート ターゲットをホストするサーバー上の共有フォルダーの名前を指定する文字列へのポインター。 このパラメーターは必須です。
[in] FtDfsName
新規または既存のドメイン ベースの DFS 名前空間の名前を指定する文字列へのポインター。 このパラメーターは必須です。 互換性上の理由から、 RootShare パラメーターと同じ文字列を指定する必要があります。
[in, optional] Comment
DFS 名前空間に関連付けられている省略可能なコメントを含む文字列へのポインター。
[in] Flags
このパラメーターは予約されており、0 である必要があります。
戻り値
関数が成功した場合、戻り値は NERR_Success。
関数が失敗した場合、戻り値はシステム エラー コードです。 エラー コードの一覧については、「 システム エラー コード」を参照してください。
解説
RootShare パラメーターで指定された共有は、新しい DFS ルート ターゲットをホストするサーバーに既に存在している必要があります。 この関数では、新しい共有は作成されません。
呼び出し元には、ディレクトリ サービス内の DFS コンテナーを更新するためのアクセス許可が必要であり、DFS ホスト (ルート) サーバーに対する管理者特権が必要です。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | lmdfs.h (LmDfs.h、Lm.h を含む) |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |