DsMergeForestTrustInformationW function

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

Syntax

DWORD WINAPI DsMergeForestTrustInformationW(
  _In_     LPCWSTR                       DomainName,
  _In_     PLSA_FOREST_TRUST_INFORMATION NewForestTrustInfo,
  _In_opt_ PLSA_FOREST_TRUST_INFORMATION OldForestTrustInfo,
  _Out_    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 value

Returns NO_ERROR if successful or a Windows error code otherwise.

Requirements

See also

Directory Service Functions

NetApiBufferFree