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

関連項目

DFS_INFO_101

DFS_INFO_102

分散ファイル システム (DFS) 関数

NetDfsGetClientInfo

ネットワーク管理機能

ネットワーク管理の概要