NetDfsSetClientInfo 関数 (lmdfs.h)
DFS クライアントによって管理されるキャッシュ内の分散ファイル システム (DFS) ルートまたはリンクに関する情報を変更します。
構文
NET_API_STATUS NET_API_FUNCTION NetDfsSetClientInfo(
[in] LPWSTR DfsEntryPath,
[in, optional] LPWSTR ServerName,
[in, optional] LPWSTR ShareName,
[in] DWORD Level,
[in] LPBYTE Buffer
);
パラメーター
[in] DfsEntryPath
DFS ルートまたはリンクの汎用名前付け規則 (UNC) パスを指定する文字列へのポインター。
リンクの場合、文字列は 2 つの形式のいずれかになります。 最初の形式は次のとおりです。
\\Servername\DfsName\link_path
ここで 、ServerName はスタンドアロン DFS 名前空間をホストするルート ターゲット サーバーの名前です。 DfsName は DFS 名前空間の名前です。 と link_path は DFS リンクです。
2 番目の形式は次のとおりです。
\\Domainname\DomDfsname\link_path
ここで、DomainName はドメイン ベースの DFS 名前空間をホストするドメインの名前です。DomDfsname は DFS 名前空間の名前です。と link_path は DFS リンクです。
ルートの場合、文字列は次の 2 つの形式のいずれかになります。
\\Servername\DfsName
or
\\Domainname\DomDfsname
ここで、名前の値は前に説明したものと同じです。
このパラメーターは必須です。
[in, optional] ServerName
DFS リンク ターゲット サーバー名を指定する文字列へのポインター。 このパラメーターは省略可能です。 詳細については、「解説」を参照してください。
[in, optional] ShareName
DFS リンク ターゲット共有名を指定する文字列へのポインター。 このパラメーターは省略可能です。 詳細については、次の「備考」セクションを参照してください。
[in] Level
要求の情報レベルを指定します。 このパラメーターには、次の値のいずれかを指定できます。
101
ローカル DFS リンクのストレージ状態を設定します。 Buffer パラメーターは、DFS_INFO_101構造体を指します。
102
ローカル DFS リンクのタイムアウトを設定します。 Buffer パラメーターは 、DFS_INFO_102 構造体を指します。 詳細については、「解説」を参照してください。
[in] Buffer
設定する情報を含むバッファーへのポインター。 この情報の形式は 、Level パラメーターの値によって異なります。 詳細については、「 ネットワーク管理機能バッファー」を参照してください。
戻り値
関数が成功した場合、戻り値は NERR_Success。
関数が失敗した場合、戻り値はシステム エラー コードです。 エラー コードの一覧については、「 システム エラー コード」を参照してください。
解説
呼び出し元には、DFS サーバーに対する管理者特権が必要です。 管理者特権を必要とする関数の呼び出しの詳細については、「 特別な特権で実行する」を参照してください。
スレッドがエントリを参照している可能性があるため、タイムアウトを 0 に設定しても、DFS リンクのローカル キャッシュ コピーが直ちに削除されない場合があります。
DFS リンクにはタイムアウトが 1 つしかないため、レベル 102 では ServerName パラメーターと ShareName パラメーターは無視されます。
DFS_STORAGE_STATE_ONLINEビットとDFS_STORAGE_STATE_OFFLINEビットは無視されます。 DFS_STORAGE_STATE_ACTIVE ビットは、アクティブなコンピューターに開いているファイルがない場合にのみ有効です。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | lmdfs.h (LmDfs.h、Lm.h を含む) |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |