DFS_INFO_8-Struktur (lmdfs.h)
Enthält den Namen, status, GUID, Timeout, Eigenschaftsflags, Metadatengröße, DFS-Zielinformationen und Linkreparsepunktsicherheitsdeskriptor für einen Stamm oder Link. Diese Struktur ist nur für die Verwendung mit den Funktionen NetDfsGetInfo und NetDfsEnum vorgesehen.
Syntax
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
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. Die DFS_VOLUME_FLAVORS Bitmaske (0x00000300) muss verwendet werden, um den DFS-Namespacegeschmack zu extrahieren, und die DFS_VOLUME_STATES Bitmaske (0x0000000F) muss verwendet werden, um den DFS-Stamm- oder Linkstatus aus diesem Member zu extrahieren. 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)
Bereich: Domänenwurzeln, eigenständige Wurzeln und Links. Wenn dieses Flag im DFS-Stamm festgelegt ist, gilt es für alle Links. andernfalls wird der Wert dieses Flags für jeden einzelnen Link berücksichtigt.
Wenn dieses Flag festgelegt ist, enthält eine DFS-Empfehlungsantwort eines DFS-Servers für einen DFS-Stamm oder -Link mit aktivierter Option "INSITE" nur die Ziele, die sich an demselben Standort befinden wie der DFS-Client, der die Empfehlung anfordert. Ziele in den beiden globalen Prioritätsklassen werden unabhängig vom Standort immer zurückgegeben.
DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
Bereich: Nur der gesamte DFS-Namespace für einen domänenbasierten DFS-Namespace.
Standardmäßig fragt ein DFS-Stammzielserver den PDS ab, um Änderungen an den DFS-Metadaten zu erkennen. Um eine hohe Serverlast auf dem PDC zu verhindern, kann die Stammskalierbarkeit für den DFS-Namespace aktiviert werden. Das Festlegen dieses Flags führt dazu, dass der DFS-Server den nächstgelegenen Domänencontroller anstelle des PDC für DFS-Metadatenänderungen für den allgemeinen Namespace abruft. Beachten Sie jedoch, dass alle Änderungen an den Metadaten weiterhin auf dem PDC erfolgen müssen.
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
Bereich: Der gesamte DFS-Namespace für domänenbasierte und eigenständige DFS-Namespaces.
Standardmäßig bestehen Ziele, die in einer Verweisantwort von einem DFS-Server an einen DFS-Client für einen DFS-Stamm oder -Link zurückgegeben werden, aus zwei Gruppen: Ziele am gleichen Standort wie der Client und Ziele außerhalb des Standorts.
Wenn Standortkosten für Active Directory aktiviert sind, kann die Antwort mehr als zwei Gruppen enthalten, wobei jede Gruppe Ziele mit den gleichen Standortkosten für den spezifischen DFS-Client enthält, der die Empfehlung anfordert. Die Gruppen werden durch Erhöhung der Websitekosten bestellt. Weitere Informationen dazu, wie Standortkosten zum Priorisieren von Zielen verwendet werden, finden Sie unter DFS-Serverzielpriorisierung.
DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)
Bereich: Domänenbasierte DFS-Wurzeln, eigenständige DFS-Wurzeln und DFS-Links. Wenn dieses Flag im DFS-Stamm festgelegt ist, gilt es für alle Links. andernfalls wird der Wert dieses Flags für jeden einzelnen Link berücksichtigt.
Wenn dieses Flag festgelegt ist, wird das optimale Ziel-Failback für V4-DFS-Clients aktiviert, sodass sie nach einem Failover zu einem nicht optimalen Ziel zu einem optimalen Ziel zurückkehren können. Die Ziel-Failbackeinstellung wird dem DFS-Client in einer V4-Empfehlungsantwort von einem DFS-Server bereitgestellt.
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
Bereich: Nur eigenständige DFS-Wurzeln und -Links.
Der DFS-Stamm wird gruppiert, um Hochverfügbarkeit für Speicherfailover bereitzustellen. 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 Feld die Größe der in der Registrierung gespeicherten Metadaten an, einschließlich der Schlüssel- und Wertnamen, zusätzlich zu den spezifischen Datenelementen, die ihnen zugeordnet sind.
Dieses Feld ist nur für DFS-Wurzeln gültig.
SecurityDescriptorLength
pSecurityDescriptor
Zeiger auf eine SECURITY_DESCRIPTOR-Struktur , die einen selbstrelativen Sicherheitsdeskriptor angibt, der dem Analysepunkt des DFS-Links zugeordnet werden soll. Dieses Feld ist nur für DFS-Links gültig.
SdLengthReserved
Dieses Element ist für die Systemverwendung reserviert.
NumberOfStorages
Gibt die Anzahl der Speicherserver für das Volume an, das den DFS-Stamm oder -Link enthält.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista mit SP1 |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Kopfzeile | lmdfs.h (include LmDfs.h, Lm.h) |