DFS_INFO_8 struttura (lmdfs.h)

Contiene il nome, lo stato, il GUID, il timeout, i flag di proprietà, le dimensioni dei metadati, le informazioni di destinazione DFS e il descrittore di sicurezza del punto di ripristino del punto per una radice o un collegamento. Questa struttura è utilizzata solo con le funzioni NetDfsGetInfo e NetDfsEnum .

Sintassi

typedef struct _DFS_INFO_8 {
  LPWSTR               EntryPath;
  LPWSTR               Comment;
  DWORD                State;
  ULONG                Timeout;
  GUID                 Guid;
  ULONG                PropertyFlags;
  ULONG                MetadataSize;
  ULONG                SecurityDescriptorLength;
#if ...
  PUCHAR               pSecurityDescriptor;
  ULONG                SdLengthReserved;
#else
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
#endif
  DWORD                NumberOfStorages;
} DFS_INFO_8, *PDFS_INFO_8, *LPDFS_INFO_8;

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, oltre agli elementi di dati specifici associati.

Questo campo è valido solo per le radici DFS.

SecurityDescriptorLength

pSecurityDescriptor

Puntatore a una struttura SECURITY_DESCRIPTOR che specifica un descrittore di sicurezza self-relativo da associare al punto di ripristino del collegamento DFS. Questo campo è valido solo per i collegamenti DFS.

SdLengthReserved

Questo membro è riservato per l'uso del sistema.

NumberOfStorages

Specifica il numero di server di archiviazione per il volume contenente la radice o il collegamento DFS.

Requisiti

Vedi anche

Funzioni di file system distribuite

NetDfsGetInfo