DFS_INFO_6 struttura (lmdfs.h)

Contiene informazioni su una radice o un collegamento DFS (Distributed File System). Questa struttura contiene il nome, lo stato, il GUID, il timeout, lo spazio dei nomi/radice/collegamento, le dimensioni dei metadati, il numero di destinazioni e le informazioni su ogni destinazione della radice o del collegamento. Questa struttura è utilizzata solo con le funzioni NetDfsEnum, NetDfsGetClientInfo e NetDfsGetInfo.

Per ottenere informazioni sullo spazio dei nomi DFS senza informazioni di destinazione , usare DFS_INFO_5 .

Sintassi

typedef struct _DFS_INFO_6 {
  LPWSTR               EntryPath;
  LPWSTR               Comment;
  DWORD                State;
  ULONG                Timeout;
  GUID                 Guid;
  ULONG                PropertyFlags;
  ULONG                MetadataSize;
  DWORD                NumberOfStorages;
#if ...
  LPDFS_STORAGE_INFO_1 Storage;
#else
  LPDFS_STORAGE_INFO_1 Storage;
#endif
} DFS_INFO_6, *PDFS_INFO_6, *LPDFS_INFO_6;

Members

EntryPath

Puntatore a una stringa Unicode con terminazione null che specifica il percorso UNIVERSAL Naming Convention (UNC) 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.

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 . Il DFS_VOLUME_FLAVORS maschera di bit ( 0x00000300) deve essere usato per estrarre il sapore dello spazio dei nomi DFS e la maschera di bit DFS_VOLUME_STATES (0x0000000F) deve essere usata per estrarre lo stato radice o collegamento DFS da questo membro. 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 della incoerenza non sono riusciti.

DFS_VOLUME_STATE_OFFLINE (0x00000003)

Il collegamento radice o radice DFS specificato è offline o non disponibile.

DFS_VOLUME_STATE_ONLINE (0x00000004)

La radice o il collegamento DFS specificato sono disponibili.

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)

Ambito: radici di dominio, radici autonome e collegamenti. Se questo flag è impostato nella radice DFS, si applica a tutti i collegamenti; in caso contrario, il valore di questo flag viene considerato per ogni singolo collegamento.

Quando questo flag è impostato, una risposta di riferimento DFS da un server DFS per una radice DFS o un collegamento con l'opzione "INSITE" abilitata contiene solo quelle destinazioni presenti nello stesso sito del client DFS che richiede la segnalazione. Le destinazioni nelle due classi di priorità globale vengono sempre restituite, indipendentemente dalla posizione del sito.

DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)

Ambito: intero spazio dei nomi DFS per uno spazio dei nomi DFS basato su dominio.

Per impostazione predefinita, un server di destinazione radice DFS esegue il polling del PDS per rilevare le modifiche ai metadati DFS. Per evitare il carico del server elevato nel PDC, la scalabilità radice può essere abilitata per lo spazio dei nomi DFS. Se si imposta questo flag, il server DFS esegue il polling del controller di dominio più vicino anziché la modifica dei metadati DFS per lo spazio dei nomi comune. Si noti che tutte le modifiche apportate ai metadati devono comunque verificarsi nel PDC.

DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)

Ambito: intero spazio dei nomi DFS per spazi dei nomi DFS basati su dominio e autonomo.

Per impostazione predefinita, le destinazioni restituite in una risposta di riferimento da un server DFS a un client DFS per una radice o un collegamento DFS sono costituite da due gruppi: destinazioni nello stesso sito del client e destinazioni all'esterno del sito.

Se il costo del sito è abilitato per Active Directory, la risposta può avere più di due gruppi, con ogni gruppo contenente destinazioni con lo stesso costo del sito per il client DFS specifico che richiede la segnalazione. I gruppi vengono ordinati aumentando i costi del sito. Per altre informazioni sul modo in cui viene usato il costo del sito per assegnare priorità alle destinazioni, vedere Priorità di destinazione del server DFS.

DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)

Ambito: radici DFS basate su dominio, radici DFS autonome e collegamenti DFS autonomi. Se questo flag è impostato nella radice DFS, si applica a tutti i collegamenti; in caso contrario, il valore di questo flag viene considerato per ogni singolo collegamento.

Quando questo flag è impostato, il failback ottimale di destinazione è abilitato per i client DFS V4, consentendo loro di eseguire il failback a una destinazione ottimale dopo il failover a uno non ottimale. L'impostazione di failback di destinazione viene fornita al client DFS in una risposta di segnalazione V4 da un server DFS.

DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)

Ambito: solo radici E collegamenti DFS autonomi.

La radice DFS è cluster per fornire disponibilità elevata per il failover di archiviazione. 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 sull'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 active Directory corrispondente, in byte. Per gli spazi dei nomi DFS autonomi, questo campo 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 campo è valido solo per le radici DFS.

NumberOfStorages

Specifica il numero di destinazioni per la radice o il collegamento DFS. Queste destinazioni sono contenute nel membro di archiviazione di questa struttura.

Storage

Specifica una matrice di strutture DFS_STORAGE_INFO_1 che contengono le informazioni di destinazione DFS.

Commenti

Per altre informazioni sul modo in cui viene determinata la priorità di destinazione del server, vedere Priorità di destinazione del server DFS.

Requisiti

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

Vedi anche

Priorità del server DFS

DFS_STORAGE_INFO_1

Funzioni DFS (Distributed File System)

NetDfsEnum

NetDfsGetClientInfo

NetDfsGetInfo

Panoramica della gestione della rete

Strutture di gestione di rete