DS_DOMAIN_TRUSTSA structure (dsgetdc.h)

Article
07/27/2022

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

Syntax

typedef struct _DS_DOMAIN_TRUSTSA {
  LPSTR NetbiosDomainName;
  LPSTR DnsDomainName;
  ULONG Flags;
  ULONG ParentIndex;
  ULONG TrustType;
  ULONG TrustAttributes;
  PSID  DomainSid;
  GUID  DomainGuid;
} DS_DOMAIN_TRUSTSA, *PDS_DOMAIN_TRUSTSA;

Members

NetbiosDomainName

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

DnsDomainName

Pointer to a null-terminated string that contains the DNS name of the domain. This member may be NULL.

Flags

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

DS_DOMAIN_IN_FOREST (1 (0x1))

The domain represented by this structure is a member of the same forest as the server specified in the ServerName parameter of the DsEnumerateDomainTrusts function.

DS_DOMAIN_DIRECT_OUTBOUND (2 (0x2))

The domain represented by this structure is directly trusted by the domain that the server specified in the ServerName parameter of the DsEnumerateDomainTrusts function is a member of.

DS_DOMAIN_TREE_ROOT (4 (0x4))

The domain represented by this structure is the root of a tree and a member of the same forest as the server specified in the ServerName parameter of the DsEnumerateDomainTrusts function.

DS_DOMAIN_PRIMARY (8 (0x8))

The domain represented by this structure is the primary domain of the server specified in the ServerName parameter of the DsEnumerateDomainTrusts function.

DS_DOMAIN_NATIVE_MODE (16 (0x10))

The domain represented by this structure is running in the Windows 2000 native mode.

DS_DOMAIN_DIRECT_INBOUND (32 (0x20))

The domain represented by this structure directly trusts the domain that the server specified in the ServerName parameter of the DsEnumerateDomainTrusts function is a member of.

ParentIndex

Contains the index in the Domains array returned by the DsEnumerateDomainTrusts function that corresponds to the parent domain of the domain represented by this structure. This member is only valid if the all of the following conditions are met:

The DS_DOMAIN_IN_FOREST flag was specified in the Flags parameter of the DsEnumerateDomainTrusts function.
The Flags member of this structure does not contain the DS_DOMAIN_TREE_ROOT flag.

TrustType

Contains a value that indicates the type of trust represented by this structure. Possible values for this member are documented in the TrustType member of the TRUSTED_DOMAIN_INFORMATION_EX structure.

TrustAttributes

Contains a value that indicates the attributes of the trust represented by this structure. Possible values for this member are documented in the TrustAttribute member of the TRUSTED_DOMAIN_INFORMATION_EX structure.

DomainSid

Contains the security identifier of the domain represented by this structure.

DomainGuid

Contains the GUID of the domain represented by this structure.

Remarks

Note

The dsgetdc.h header defines DS_DOMAIN_TRUSTS as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Header	dsgetdc.h

Share via