NetDfsSetInfo 函式 (lmdfs.h)
設定或修改特定分散式檔案系統 (DFS) 根、根目標、連結或連結目標的相關資訊。
語法
NET_API_STATUS NET_API_FUNCTION NetDfsSetInfo(
[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 連結目標共用名稱稱之字串的指標。 這也可能是與共享相對路徑的共用名稱。 例如，「share1\mydir1\mydir2」。 這是選擇性參數。 如需詳細資訊，請參閱＜備註＞一節。
[in] Level
指定資料的資訊層級。 此參數可以是下列其中一個值。
100
設定與 DfsEntryPath 參數中指定的 DFS 根或連結相關聯的批註。 Buffer參數會指向DFS_INFO_100結構。
101
設定與 DfsEntryPath 參數中指定的 DFS 根或連結相關聯的儲存狀態。 Buffer參數會指向DFS_INFO_101結構。
102
設定與 DfsEntryPath 參數中指定的 DFS 根目錄或連結相關聯的逾時值。 Buffer參數會指向DFS_INFO_102結構。
103
設定 DfsEntryPath 參數中所指定 DFS 根目錄或連結的屬性旗標。 Buffer參數會指向DFS_INFO_103結構。
104
為 DfsEntryPath 參數中指定的根目標或連結目標設定目標優先順序和類別。 Buffer參數會指向DFS_INFO_104結構。
105
針對 DfsEntryPath 參數中指定的 DFS 根目錄或連結，設定批註、狀態和逾時資訊以及屬性旗標。 Buffer參數會指向DFS_INFO_105結構。
106
設定 DfsEntryPath 參數中所指定根目標或連結目標的目標狀態和優先順序。 這項資訊無法針對 DFS 命名空間根目錄或連結進行設定，僅適用于根目標或連結目標。 Buffer參數會指向DFS_INFO_106結構。
107
設定 DfsEntryPath 參數中所指定 DFS 根目錄或連結的批註、狀態、逾時資訊和屬性旗標。 針對 DFS 連結，您也可以設定連結重新分析點的安全性描述項。 Buffer參數會指向DFS_INFO_107結構。
150
設定 DFS 連結重新分析點的安全性描述項。 Buffer參數會指向DFS_INFO_150結構。
[in] Buffer
指定資料的緩衝區指標。 此資料的格式取決於 Level 參數的值。 如需詳細資訊，請參閱 網路管理功能緩衝區。
傳回值
如果函式成功，傳回值會NERR_Success。
如果函式失敗，則傳回值是系統錯誤碼。 如需錯誤碼的清單，請參閱 系統錯誤碼。
備註
呼叫端必須在 DFS 伺服器上具有系統管理員許可權。 如需呼叫需要系統管理員許可權之函式的詳細資訊，請參閱 以特殊許可權執行。
如果您同時指定 ServerName 和 ShareName 參數， NetDfsSetInfo 函 式會設定或修改該根目標或連結目標的特定資訊。 如果參數為 Null，函式會設定或修改 DFS 命名空間根目錄或 DFS 連結的特定資訊，而不是特定的 DFS 根目標或連結目標。
因為 DFS 根目錄或連結只能設定一個批註和一個逾時， 所以針對 資訊層級 100 和 102 會忽略 ServerName 和 ShareName 參數。 層級 101 需要這些參數。
針對資訊層級 101，當 DFS 命名空間有多個 DFS 根目標時，可以針對特定網域型 DFS 根目錄設定 DFS_VOLUME_STATE_RESYNCHRONIZE 和 DFS_VOLUME_STATE_STANDBY 狀態值：
DfsEntryPath參數會指定網域型 DFS 命名空間，而ServerName和ShareName參數會一起指定要執行設定資訊作業的 DFS 根目標。
範例
下列程式碼範例示範如何使用 對 NetDfsSetInfo 函式的呼叫，將批註與 DFS 連結產生關聯。 此範例會指定資訊層級 100 (DFS_INFO_100) 。
#include <windows.h>
#include <lm.h>
#include <lmdfs.h>
#include <stdio.h>
#pragma comment(lib, "Netapi32.lib")
void wmain(int argc, wchar_t *argv[])
{
DFS_INFO_100 dfsData;
DWORD res;
//
// Check command line arguments.
//
if (argc<2)
wprintf(L"Syntax: %s DfsEntryPath [\"Comment\"]\n", argv[0]);
else
{
//
// Fill in DFS_INFO_100 structure member.
//
dfsData.Comment = argc < 3 ? NULL : argv[2];
//
// Call the NetDfsSetInfo function, specifying level 100.
//
res = NetDfsSetInfo(argv[1], NULL, NULL, 100, (LPBYTE) &dfsData);
//
// Display the result of the call.
//
if(res == 0)
printf("Comment set.\n");
else
printf("Error: %u", res);
}
return;
}
需求
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | lmdfs.h (包括 LmDfs.h、Lm.h) |
| 程式庫 | Netapi32.lib |
| Dll | Netapi32.dll |