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_ONLINE 和 DFS_STORAGE_STATE_OFFLINE 位。 只有當沒有檔案開啟至使用中電腦時 ,DFS_STORAGE_STATE_ACTIVE 位才有效。
需求
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | lmdfs.h (包括 LmDfs.h、Lm.h) |
程式庫 | Netapi32.lib |
Dll | Netapi32.dll |