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

如果您同時指定 ServerNameShareName 參數, NetDfsSetInfo 函 式會設定或修改該根目標或連結目標的特定資訊。 如果參數為 Null,函式會設定或修改 DFS 命名空間根目錄或 DFS 連結的特定資訊,而不是特定的 DFS 根目標或連結目標。

因為 DFS 根目錄或連結只能設定一個批註和一個逾時, 所以針對 資訊層級 100 和 102 會忽略 ServerName 和 ShareName 參數。 層級 101 需要這些參數。

針對資訊層級 101,當 DFS 命名空間有多個 DFS 根目標時,可以針對特定網域型 DFS 根目錄設定 DFS_VOLUME_STATE_RESYNCHRONIZEDFS_VOLUME_STATE_STANDBY 狀態值:

DfsEntryPath參數會指定網域型 DFS 命名空間,而ServerNameShareName參數會一起指定要執行設定資訊作業的 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

另請參閱

DFS_INFO_100

DFS_INFO_101

DFS_INFO_102

DFS_INFO_103

DFS_INFO_104

DFS_INFO_105

DFS_INFO_106

DFS_INFO_107

DFS_INFO_150

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

NetDfsEnum

網路管理功能

網路管理概觀