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
Funzioni DFS (Distributed File System)
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per