DS_DOMAIN_TRUSTS

The DS_DOMAIN_TRUSTS structure is used with the DsEnumerateDomainTrusts function to contain trust data for a domain.

typedef struct _DS_DOMAIN_TRUSTS {

  LPTSTR NetbiosDomainName;

  LPTSTR DnsDomainName;

  ULONG Flags;

  ULONG ParentIndex;

  ULONG TrustType;

  ULONG TrustAttributes;

  PSID DomainSid;

  GUID DomainGuid;
} DS_DOMAIN_TRUSTS, 

*PDS_DOMAIN_TRUSTS;

Members

NetbiosDomainName

Pointer a null-terminated string that contains the NetBIOS name of the domain.

DnsDomainName

Pointer a null-terminated string that contains the DNS name of the returned domain.

Flags

Contains a set of flags that specify attributes of the domain trust. This can be zero or a combination of one or more of the following values.

Value	Meaning
DS_DOMAIN_DIRECT_INBOUND	The domain directly trusts the domain which has ServerName as a member.
DS_DOMAIN_DIRECT_OUTBOUND	The domain is directly trusted.
DS_DOMAIN_IN_FOREST	The domain is a member of the same forest which has ServerName as a member.
DS_DOMAIN_NATIVE_MODE	The primary domain is running in the Windows 2000® native mode.
DS_DOMAIN_PRIMARY	The domain is the primary domain of the queried server.
DS_DOMAIN_TREE_ROOT	The domain is the root of a tree and member of the same forest which has ServerName as a member.

ParentIndex

An integer index between 0 (inclusive) and the DomainCount (exclusive) that specifies an index in the returned array Domains that correspond to the parent domain of the returned domain. The value of this parameter is valid only if DS_DOMAIN_IN_FOREST was specified in the input Flags parameter of the DsEnumerateDomainTrusts function and the Flags parameter of this structure does not have the DS_DOMAIN_TREE_ROOT bit set.

TrustType

Specifies one of the following values to indicate the type of trust relationship. These values also correspond to the same parameter (TrustType) in the LSA (Local Security Authority) functions.

Value	Meaning
TRUST_TYPE_DCE	The trusted domain is a DCE realm.
TRUST_TYPE_DOWNLEVEL	The domain controller of the trusted domain is a Windows NT® 4.0 or earlier system.
TRUST_TYPE_MIT	The trusted domain is an MIT Kerberos realm.
TRUST_TYPE_UPLEVEL	The domain controller of the trusted domain is a Windows® 2000 or later system.

TrustAttributes

The trust attributes of the trust. These values also correspond to the same parameter (TrustAttribute) in the LSA (Local Security Authority) functions.

Value	Meaning
TRUST_ATTRIBUTE_NON_TRANSITIVE	Disable transitivity.
TRUST_ATTRIBUTE_TREE_PARENT	Denotes the trust setting to the parent in the organization tree.
TRUST_ATTRIBUTE_TREE_ROOT	Denotes the trust setting to another tree root in the forest.
TRUST_ATTRIBUTE_UPLEVEL_ONLY	Trusted link valid only for uplevel client.

DomainSid

The Security ID of the domain.

DomainGuid

The GUID of the domain.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Unicode: Declared as Unicode and ANSI structures.
Header: Declared in Dsgetdc.h.

See Also

Directory Service Structures, DsEnumerateDomainTrusts