DsMergeForestTrustInformationW

The DsMergeForestTrustInformationW function merges the changes from a new forest trust data structure with an old forest trust data structure.

void DsMergeForestTrustInformationW(
  LPCWSTR DomainName,
  PLSA_FOREST_TRUST_INFORMATION NewForestTrustInfo,
  PLSA_FOREST_TRUST_INFORMATION OldForestTrustInfo,
  PLSA_FOREST_TRUST_INFORMATION* ForestTrustInfo
);

Parameters

DomainName

[in] Pointer to a null-terminated Unicode string that specifies the trusted domain to update.

NewForestTrustInfo

[in] Pointer to an LSA_FOREST_TRUST_INFORMATION structure that contains the new forest trust data to be merged. The Flags and Time members of the entries are ignored.

OldForestTrustInfo

[in, optional] Pointer to an LSA_FOREST_TRUST_INFORMATION structure that contains the old forest trust data to be merged. This parameter may be NULL if no records exist.

ForestTrustInfo

[out] Pointer to an LSA_FOREST_TRUST_INFORMATION structure pointer that receives the merged forest trust data.

The caller must free this structure when it is no longer required by calling NetApiBufferFree.

Return Values

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Unicode: Implemented as Unicode version only.
Header: Declared in Dsgetdc.h.
Library: Use Netapi32.lib.

See Also

NetApiBufferFree, Directory Service Functions