struttura DFS_INFO_5 (lmdfs.h)

Articolo
03/14/2023

Contiene informazioni su una radice o un collegamento DFS (Distributed File System). Questa struttura contiene il nome, lo stato, il GUID, il timeout, le proprietà dello spazio dei nomi/radice/collegamento, le dimensioni dei metadati e il numero di destinazioni per la radice o il collegamento. Questa struttura è utilizzabile solo con le funzioni NetDfsEnum, NetDfsGetClientInfo e NetDfsGetInfo .

Per recuperare informazioni sulle destinazioni dello spazio dei nomi DFS, usare invece DFS_INFO_6 .

Sintassi

typedef struct _DFS_INFO_5 {
  LPWSTR EntryPath;
  LPWSTR Comment;
  DWORD  State;
  ULONG  Timeout;
  GUID   Guid;
  ULONG  PropertyFlags;
  ULONG  MetadataSize;
  DWORD  NumberOfStorages;
} DFS_INFO_5, *PDFS_INFO_5, *LPDFS_INFO_5;

Members

EntryPath

Puntatore a una stringa Unicode con terminazione Null 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 formato è 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 seguenti:

\\Nomeserver\DfsName

oppure

\\Domainname\DomDfsname

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

Comment

Puntatore a una stringa Unicode con terminazione Null contenente un commento associato alla radice o al collegamento DFS.

State

Specifica un set di flag di bit che descrivono la radice o il collegamento DFS. Viene impostato un flag DFS_VOLUME_STATE e viene impostato un flag DFS_VOLUME_FLAVOR . Per un esempio che descrive l'interpretazione dei flag, vedere la sezione Osservazioni di DFS_INFO_2.

DFS_VOLUME_STATE_OK (0x00000001)

La radice o il collegamento DFS specificato si trova nello stato normale.

DFS_VOLUME_STATE_INCONSISTENT (0x00000002)

Il database DFS interno non è coerente con la radice o il collegamento DFS specificato. I tentativi di ripristino dell'incoerenza non sono riusciti.

DFS_VOLUME_STATE_OFFLINE (0x00000003)

La radice O il collegamento DFS specificato è offline o non disponibile.

DFS_VOLUME_STATE_ONLINE (0x00000004)

La radice O il collegamento DFS specificato è disponibile.

DFS_VOLUME_FLAVOR_STANDALONE (0x00000100)

Il sistema imposta questo flag se la radice è associata a uno spazio dei nomi DFS autonomo.

DFS_VOLUME_FLAVOR_AD_BLOB (0x00000200)

Il sistema imposta questo flag se la radice è associata a uno spazio dei nomi DFS basato su dominio.

Timeout

Specifica il timeout, in secondi, della radice O del collegamento DFS.

Guid

Specifica il GUID della radice o del collegamento DFS.

PropertyFlags

Specifica un set di flag che descrivono proprietà specifiche di uno spazio dei nomi, una radice o un collegamento DFS.

DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)

Vengono restituite solo le destinazioni nello stesso sito del client. Questo flag è valido sia per le radici che per i collegamenti autonomi e di dominio.

DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)

Il controller di dominio più vicino viene eseguito il polling anziché il PDC per le modifiche dello spazio dei nomi DFS. Questo flag è valido solo per le radici del dominio.

DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)

Il costo del sito di Active Directory per le destinazioni è abilitato, raggruppando le destinazioni in set di costi crescenti del sito dal client DFS alla destinazione. Ogni set ha destinazioni con lo stesso costo. Questo flag è valido solo per le radici autonome e di dominio.

DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)

Il client DFS esegue il failback a una destinazione più vicina disponibile dopo il failover a una destinazione non ottimale. Questo flag è valido sia per le radici che per i collegamenti autonomi e di dominio.

DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)

La radice DFS è in cluster. Questo flag non può essere impostato usando la funzione NetDfsSetInfo .

DFS_PROPERTY_FLAG_ABDE (0x00000020)

Ambito: radici DFS basate su dominio e radici DFS autonome.

Quando questo flag è impostato, Access-Based supporto della modalità di enumerazione directory (ABDE) è abilitato nell'intera condivisione di destinazione radice DFS dello spazio dei nomi DFS. Questo flag è valido solo per gli spazi dei nomi DFS per i quali è impostato il flag di funzionalità DFS_NAMESPACE_CAPABILITY_ABDE . Per altre informazioni, vedere DFS_INFO_50 e DFS_SUPPORTED_NAMESPACE_VERSION_INFO.

Il flag DFS_PROPERTY_FLAG_ABDE è valido solo nella radice dello spazio dei nomi DFS e non nelle destinazioni radice, collegamenti o destinazioni di collegamento. Questo flag deve essere abilitato per associare un descrittore di sicurezza a un collegamento DFS.

MetadataSize

Per gli spazi dei nomi DFS basati su dominio, questo membro specifica le dimensioni del BLOB di dati di Active Directory corrispondente, in byte. Per gli spazi dei nomi DFS autonomi, questo membro specifica le dimensioni dei metadati archiviati nel Registro di sistema, inclusi i nomi delle chiavi e i nomi dei valori, nonché gli elementi di dati specifici associati.

Questo membro è valido solo per le radici DFS.

NumberOfStorages

Specifica il numero di destinazioni per la radice o il collegamento DFS.

Commenti

Per recuperare informazioni sulle destinazioni e sulle priorità di destinazione, usare la struttura DFS_INFO_6 . DFS_INFO_5 viene usato per specificare informazioni su uno spazio dei nomi DFS senza informazioni di destinazione.

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008, Windows Server 2008
Intestazione	lmdfs.h (include LmDfs.h, Lm.h)