NetDfsSetInfo-Funktion (lmdfs.h)

Artikel
08/24/2023

Legt Informationen zu einem bestimmten DFS-Stamm- (Distributed File System), Stammziel, Link oder Linkziel fest oder ändert diese.

Syntax

NET_API_STATUS NET_API_FUNCTION NetDfsSetInfo(
  [in]           LPWSTR DfsEntryPath,
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR ShareName,
  [in]           DWORD  Level,
  [in]           LPBYTE Buffer
);

Parameter

[in] DfsEntryPath

Zeiger auf eine Zeichenfolge, die den UNC-Pfad (Universal Naming Convention) eines DFS-Stamms oder -Links angibt.

Für einen Link kann die Zeichenfolge in einer von zwei Formen sein. Das erste Formular lautet wie folgt:

\\Servername\DfsName\link_path

wobei ServerName der Name des Stammzielservers ist, der den eigenständigen DFS-Namespace hostet; DfsName ist der Name des DFS-Namespace. und link_path ein DFS-Link ist.

Das zweite Formular lautet wie folgt:

\\Domänenname\DomDfsname\link_path

wobei DomainName der Name der Domäne ist, die den domänenbasierten DFS-Namespace hostet; DomDfsname ist der Name des DFS-Namespace. und link_path ein DFS-Link ist.

Bei einem Stamm kann sich die Zeichenfolge in einer von zwei Formen befinden:

\\Servername\DfsName

oder

\\Domänenname\DomDfsname

wobei die Werte der Namen mit den zuvor beschriebenen identisch sind.

[in, optional] ServerName

Zeiger auf eine Zeichenfolge, die den Namen des DFS-Linkzielservers angibt. Dieser Parameter ist optional. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

[in, optional] ShareName

Zeiger auf eine Zeichenfolge, die den Namen der DFS-Link-Zielfreigabe angibt. Dies kann auch ein Freigabename mit einem Pfad relativ zur Freigabe sein. Beispiel: "share1\mydir1\mydir2". Dieser Parameter ist optional. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

[in] Level

Gibt die Informationsebene der Daten an. Dieser Parameter kann einen der folgenden Werte annehmen.

100

Legen Sie den Kommentar fest, der dem DFS-Stamm oder -Link zugeordnet ist, der im DfsEntryPath-Parameter angegeben ist. Der Buffer-Parameter verweist auf eine DFS_INFO_100-Struktur .

101

Legen Sie den Speicherstatus fest, der dem DFS-Stamm oder -Link zugeordnet ist, der im DfsEntryPath-Parameter angegeben ist. Der Buffer-Parameter verweist auf eine DFS_INFO_101 Struktur.

102

Legen Sie den Timeoutwert fest, der dem DFS-Stamm oder -Link zugeordnet ist, der im DfsEntryPath-Parameter angegeben ist. Der Buffer-Parameter verweist auf eine DFS_INFO_102-Struktur .

103

Legen Sie die Eigenschaftenflags für den DFS-Stamm oder -Link fest, der im DfsEntryPath-Parameter angegeben ist. Der Buffer-Parameter verweist auf eine DFS_INFO_103-Struktur .

104

Legen Sie den Rang und die Klasse der Zielpriorität für das Stammziel oder das Linkziel fest, das im DfsEntryPath-Parameter angegeben ist. Der Buffer-Parameter verweist auf eine DFS_INFO_104-Struktur .

105

Legen Sie die Kommentar-, Zustands- und Timeoutinformationen sowie Eigenschaftsflags für den DFS-Stamm oder -Link fest, der im DfsEntryPath-Parameter angegeben ist. Der Buffer-Parameter verweist auf eine DFS_INFO_105-Struktur .

106

Legen Sie den Zielzustand und die Priorität für das Stamm- oder Linkziel fest, das im DfsEntryPath-Parameter angegeben ist. Diese Informationen können nicht für einen DFS-Namespacestamm oder -Link festgelegt werden, nur für ein Stamm- oder Linkziel. Der Buffer-Parameter verweist auf eine DFS_INFO_106 Struktur.

107

Legen Sie die Kommentar-, Status-, Timeout- und Eigenschaftsflags für den DFS-Stamm oder -Link fest, der im DfsEntryPath-Parameter angegeben ist. Für DFS-Links können Sie auch die Sicherheitsbeschreibung für den Überprüfungspunkt des Links festlegen. Der Buffer-Parameter verweist auf eine DFS_INFO_107 Struktur.

150

Legen Sie die Sicherheitsbeschreibung für den Analysepunkt eines DFS-Links fest. Der Buffer-Parameter verweist auf eine DFS_INFO_150-Struktur .

[in] Buffer

Zeiger auf einen Puffer, der die Daten angibt. Das Format dieser Daten hängt vom Wert des Parameters Level ab. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode. Eine Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Der Aufrufer muss über Administratorrechte auf dem DFS-Server verfügen. Weitere Informationen zum Aufrufen von Funktionen, die Administratorrechte erfordern, finden Sie unter Ausführen mit speziellen Berechtigungen.

Wenn Sie sowohl die Parameter ServerName als auch ShareName angeben, legt die NetDfsSetInfo-Funktion informationen fest oder ändert sie, die für dieses Stamm- oder Linkziel spezifisch sind. Wenn die Parameter NULL sind, legt oder ändert die Funktion Informationen, die für den DFS-Namespacestamm oder den DFS-Link spezifisch sind, anstelle eines bestimmten DFS-Stamm- oder Linkziels.

Da nur ein Kommentar und ein Timeout für einen DFS-Stamm oder -Link festgelegt werden können, werden die Parameter ServerName und ShareName für die Informationsebenen 100 und 102 ignoriert. Diese Parameter sind für Ebene 101 erforderlich.

Für die Informationsebene 101 können die DFS_VOLUME_STATE_RESYNCHRONIZE - und DFS_VOLUME_STATE_STANDBY-Zustandswerte für einen bestimmten domänenbasierten DFS-Stamm wie folgt festgelegt werden, wenn mehrere DFS-Stammziele für den DFS-Namespace vorhanden sind:

Der DfsEntryPath-Parameter gibt den domänenbasierten DFS-Namespace an, und die Parameter ServerName und ShareName geben zusammen das DFS-Stammziel an, für das der Set-Information-Vorgang ausgeführt werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie einen Kommentar einem DFS-Link mithilfe eines Aufrufs der NetDfsSetInfo-Funktion zuordnen. Das Beispiel gibt die Informationsebene 100 (DFS_INFO_100) an.

#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;
}

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	lmdfs.h (include LmDfs.h, Lm.h)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll