Funzione NetDfsSetInfo (lmdfs.h)

Articolo
08/24/2023

Imposta o modifica le informazioni relative a una radice di file system distribuita specifica, destinazione radice, collegamento o destinazione collegamento.

Sintassi

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

Parametri

[in] DfsEntryPath

Puntatore a una stringa che specifica il percorso UNC (Universal Naming Convention) di una radice o un collegamento DFS.

Per un collegamento, la stringa può essere in una delle due forme. Il primo modulo è il seguente:

\\Nomeserver\DfsName\link_path

dove ServerName è il nome del server di destinazione radice che ospita lo spazio dei nomi DFS autonomo; DfsName è il nome dello spazio dei nomi DFS; e link_path è un collegamento DFS.

Il secondo modulo è il seguente:

\\Domainname\DomDfsname\link_path

dove DomainName è il nome del dominio che ospita lo spazio dei nomi DFS basato su dominio; DomDfsname è il nome dello spazio dei nomi DFS; e link_path è un collegamento DFS.

Per una radice, la stringa può essere in una delle due forme:

\\Nomeserver\DfsName

oppure

\\Domainname\DomDfsname

dove i valori dei nomi sono uguali a quelli descritti in precedenza.

[in, optional] ServerName

Puntatore a una stringa che specifica il nome del server di destinazione del collegamento DFS. Questo parametro è facoltativo e, Per altre informazioni, vedere la sezione Osservazioni.

[in, optional] ShareName

Puntatore a una stringa che specifica il nome della condivisione di destinazione del collegamento DFS. Questo può anche essere un nome di condivisione con un percorso relativo alla condivisione. Ad esempio, "share1\mydir1\mydir2". Questo parametro è facoltativo e, Per altre informazioni, vedere la sezione Osservazioni.

[in] Level

Specifica il livello di informazioni dei dati. Questo parametro può avere uno dei valori seguenti.

100

Impostare il commento associato alla radice o al collegamento DFS specificato nel parametro DfsEntryPath . Il parametro Buffer punta a una struttura DFS_INFO_100 .

101

Impostare lo stato di archiviazione associato alla radice o al collegamento DFS specificato nel parametro DfsEntryPath . Il parametro Buffer punta a una struttura DFS_INFO_101 .

102

Impostare il valore di timeout associato alla radice o al collegamento DFS specificato nel parametro DfsEntryPath . Il parametro Buffer punta a una struttura DFS_INFO_102 .

103

Impostare i flag di proprietà per la radice O il collegamento DFS specificato nel parametro DfsEntryPath . Il parametro Buffer punta a una struttura DFS_INFO_103 .

104

Impostare la classificazione e la classe di priorità di destinazione per la destinazione radice o la destinazione del collegamento specificata nel parametro DfsEntryPath . Il parametro Buffer punta a una struttura DFS_INFO_104 .

105

Impostare le informazioni di commento, stato e timeout, nonché flag di proprietà, per la radice o il collegamento DFS specificato nel parametro DfsEntryPath . Il parametro Buffer punta a una struttura DFS_INFO_105 .

106

Impostare lo stato di destinazione e la priorità per la destinazione radice o la destinazione di collegamento specificata nel parametro DfsEntryPath . Queste informazioni non possono essere impostate per una radice o un collegamento dello spazio dei nomi DFS, solo per una destinazione radice o una destinazione di collegamento. Il parametro Buffer punta a una struttura DFS_INFO_106 .

107

Impostare i flag di commento, stato, timeout e proprietà per la radice o il collegamento DFS specificato nel parametro DfsEntryPath . Per i collegamenti DFS, è anche possibile impostare il descrittore di sicurezza per il punto di ripristino del collegamento. Il parametro Buffer punta a una struttura DFS_INFO_107 .

150

Impostare il descrittore di sicurezza per il punto di reparse di un collegamento DFS. Il parametro Buffer punta a una struttura DFS_INFO_150 .

[in] Buffer

Puntatore a un buffer che specifica i dati. Il formato di questi dati dipende dal valore del parametro Level . Per altre informazioni, vedere Buffer delle funzioni di gestione della rete.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NERR_Success.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema. Per un elenco di codici di errore, vedere Codici di errore di sistema.

Commenti

Il chiamante deve avere privilegi di amministratore nel server DFS. Per altre informazioni sulla chiamata di funzioni che richiedono privilegi di amministratore, vedere Esecuzione con privilegi speciali.

Se si specificano entrambi i parametri ServerName e ShareName , la funzione NetDfsSetInfo imposta o modifica le informazioni specifiche della destinazione radice o della destinazione del collegamento. Se i parametri sono NULL, i set di funzioni o modificano le informazioni specifiche per la radice dello spazio dei nomi DFS o il collegamento DFS anziché una destinazione radice O collegamento DFS specifica.

Poiché è possibile impostare un solo commento e un timeout per una radice o un collegamento DFS, i parametri ServerName e ShareName vengono ignorati per i livelli di informazioni 100 e 102. Questi parametri sono necessari per il livello 101.

Per informazioni sul livello 101, i valori di stato DFS_VOLUME_STATE_RESYNCHRONIZE e DFS_VOLUME_STATE_STANDBY possono essere impostati come indicato di seguito per una radice DFS specifica basata su dominio quando è presente più di una destinazione radice DFS per lo spazio dei nomi DFS:

Il parametro DfsEntryPath specifica lo spazio dei nomi DFS basato su dominio e i parametri ServerName e ShareName presi insieme specificano la destinazione radice DFS in cui deve essere eseguita l'operazione set-information.

Esempio

L'esempio di codice seguente illustra come associare un commento a un collegamento DFS usando una chiamata alla funzione NetDfsSetInfo . L'esempio specifica il livello di informazioni 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;
}

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	lmdfs.h (include LmDfs.h, Lm.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll