Directory Services

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

Returns NO_ERROR if successful or a Win32 error code otherwise.

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