共用方式為


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) 路徑 (通用命名慣例的字串指標。

對於連結,字串可以是兩種形式之一。 第一個表單如下所示:

\\ ServerName\DfsName\link_path

其中 ServerName 是裝載獨立 DFS 命名空間之根目標伺服器的名稱; DfsName 是 DFS 命名空間的名稱;和 link_path 是 DFS 連結。

第二個表單如下所示:

\\ DomainName\DomDfsname\link_path

其中 DomainName 是裝載網域型 DFS 命名空間的功能變數名稱; DomDfsname 是 DFS 命名空間的名稱;和 link_path 是 DFS 連結。

針對根目錄,字串可以是下列兩種形式之一:

\\ ServerName\DfsName

\\ 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 伺服器上具有系統管理員許可權。 如需呼叫需要系統管理員許可權之函式的詳細資訊,請參閱 以特殊許可權執行

將逾時設定為零可能不會立即刪除 DFS 連結的本機快取複本,因為執行緒可能會參考專案。

因為 DFS 連結上只有一個逾時, 所以層級 102 會忽略 ServerName 和 ShareName 參數。

將會忽略 DFS_STORAGE_STATE_ONLINEDFS_STORAGE_STATE_OFFLINE 位。 只有當沒有檔案開啟至使用中電腦時 ,DFS_STORAGE_STATE_ACTIVE 位才有效。

需求

   
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 lmdfs.h (包括 LmDfs.h、Lm.h)
程式庫 Netapi32.lib
Dll Netapi32.dll

另請參閱

DFS_INFO_101

DFS_INFO_102

分散式檔案系統 (DFS) 函式

NetDfsGetClientInfo

網路管理功能

網路管理概觀