DFS_INFO_5-Struktur (lmdfs.h)
Enthält Informationen zu einem DFS-Stammstamm oder -link (Distributed File System). Diese Struktur enthält den Namen, die status, die GUID, das Timeout, die Namespace-/Root-/Linkeigenschaften, die Metadatengröße und die Anzahl der Ziele für den Stamm oder Link. Diese Struktur ist nur für die Verwendung mit den Funktionen NetDfsEnum, NetDfsGetClientInfo und NetDfsGetInfo vorgesehen.
Um Informationen zu den Zielen des DFS-Namespace abzurufen, verwenden Sie stattdessen DFS_INFO_6 .
Syntax
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
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den UNC-Pfad (Universal Naming Convention) eines DFS-Stamms oder -Links angibt.
Für einen Link kann die Zeichenfolge in einer von zwei Formen sein. Das erste Formular lautet wie folgt:
\\ Servername\DfsName\link_path
wobei ServerName der Name des Stammzielservers ist, der den eigenständigen DFS-Namespace hostet; DfsName ist der Name des DFS-Namespace. und link_path ein DFS-Link ist.
Das zweite Formular lautet wie folgt:
\\ Domänenname\DomDfsname\link_path
wobei DomainName der Name der Domäne ist, die den domänenbasierten DFS-Namespace hostet; DomDfsname ist der Name des DFS-Namespace. und link_path ein DFS-Link ist.
Bei einem Stamm kann sich die Zeichenfolge in einer von zwei Formen befinden:
\\ Servername\DfsName
oder
\\ Domänenname\DomDfsname
wobei die Werte der Namen mit den zuvor beschriebenen identisch sind.
Comment
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die einen Kommentar enthält, der dem DFS-Stamm oder -Link zugeordnet ist.
State
Gibt eine Reihe von Bitflags an, die den DFS-Stamm oder -Link beschreiben. Ein DFS_VOLUME_STATE Flag ist festgelegt, und ein DFS_VOLUME_FLAVOR Flag ist festgelegt. Ein Beispiel, das die Interpretation der Flags beschreibt, finden Sie im Abschnitt Anmerkungen von DFS_INFO_2.
DFS_VOLUME_STATE_OK (0x00000001)
Der angegebene DFS-Stamm oder -Link befindet sich im normalen Zustand.
DFS_VOLUME_STATE_INCONSISTENT (0x00000002)
Die interne DFS-Datenbank ist mit dem angegebenen DFS-Stamm oder -Link inkonsistent. Versuche, die Inkonsistenz zu reparieren, sind fehlgeschlagen.
DFS_VOLUME_STATE_OFFLINE (0x00000003)
Der angegebene DFS-Stamm oder -Link ist offline oder nicht verfügbar.
DFS_VOLUME_STATE_ONLINE (0x00000004)
Der angegebene DFS-Stamm oder -Link ist verfügbar.
DFS_VOLUME_FLAVOR_STANDALONE (0x00000100)
Das System legt dieses Flag fest, wenn der Stamm einem eigenständigen DFS-Namespace zugeordnet ist.
DFS_VOLUME_FLAVOR_AD_BLOB (0x00000200)
Das System legt dieses Flag fest, wenn der Stamm einem domänenbasierten DFS-Namespace zugeordnet ist.
Timeout
Gibt das Timeout des DFS-Stamms oder -Links in Sekunden an.
Guid
Gibt die GUID des DFS-Stamms oder -Links an.
PropertyFlags
Gibt eine Reihe von Flags an, die bestimmte Eigenschaften eines DFS-Namespaces, Stammstamms oder -Links beschreiben.
DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)
Nur Ziele am selben Standort wie der Client werden zurückgegeben. Dieses Flag gilt sowohl für Domänen- als auch für eigenständige Stamm- und Links.
DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
Anstelle der PDC-Namespaceänderungen wird der nächstgelegene Domänencontroller abgefragt. Dieses Flag ist nur für Domänenstammstamme gültig.
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
Active Directory-Standortkosten für Ziele sind aktiviert, wobei Ziele in Gruppen von steigenden Standortkosten vom DFS-Client zum Ziel gruppiert werden. Jede Gruppe hat Ziele mit den gleichen Kosten. Dieses Flag ist nur für Domänen- und eigenständige Stammstämme gültig.
DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)
Der DFS-Client schlägt zu einem näher verfügbaren Ziel zurück, nachdem ein Failover zu einem nicht optimalen Ziel ausgeführt wurde. Dieses Flag gilt sowohl für Domänen- als auch für eigenständige Stamm- und Links.
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
Der DFS-Stamm ist gruppiert. Dieses Flag kann nicht mit der NetDfsSetInfo-Funktion festgelegt werden.
DFS_PROPERTY_FLAG_ABDE (0x00000020)
Bereich: Domänenbasierte DFS-Wurzeln und eigenständige DFS-Wurzeln.
Wenn dieses Flag festgelegt ist, wird Access-Based ABDE-Modusunterstützung (Directory Enumeration) für die gesamte DFS-Stammzielfreigabe des DFS-Namespace aktiviert. Dieses Flag ist nur für DFS-Namespaces gültig, für die das DFS_NAMESPACE_CAPABILITY_ABDE-Funktionsflag festgelegt ist. Weitere Informationen finden Sie unter DFS_INFO_50 und DFS_SUPPORTED_NAMESPACE_VERSION_INFO.
Das flag DFS_PROPERTY_FLAG_ABDE ist nur für den DFS-Namespacestamm und nicht für Stammziele, Links oder Linkziele gültig. Dieses Flag muss aktiviert sein, um eine Sicherheitsbeschreibung einem DFS-Link zuzuordnen.
MetadataSize
Für domänenbasierte DFS-Namespaces gibt dieses Mitglied die Größe des entsprechenden Active Directory-Datenblobs in Bytes an. Für eigenständige DFS-Namespaces gibt dieses Member die Größe der in der Registrierung gespeicherten Metadaten an, einschließlich der Schlüssel- und Wertnamen sowie der ihnen zugeordneten spezifischen Datenelemente.
Dieses Element ist nur für DFS-Wurzeln gültig.
NumberOfStorages
Gibt die Anzahl der Ziele für den DFS-Stamm oder -Link an.
Hinweise
Um Informationen zu Zielen und Zielprioritäten abzurufen, verwenden Sie die DFS_INFO_6-Struktur . DFS_INFO_5 wird verwendet, um Informationen zu einem DFS-Namespace ohne Zielinformationen anzugeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008, Windows Server 2008 |
| Kopfzeile | lmdfs.h (include LmDfs.h, Lm.h) |
Weitere Informationen
DFS-Funktionen (Distributed File System)