Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Dsgetdc.h

Library

Netapi32.lib

DLL

Netapi32.dll

See also

Directory Service Functions
NetApiBufferFree

 

 

Show:
© 2014 Microsoft. All rights reserved.