DsMergeForestTrustInformationW-Funktion (dsgetdc.h)

Die DsMergeForestTrustInformationW-Funktion führt die Änderungen einer neuen Gesamtstrukturvertrauensdatenstruktur mit einer alten Datenstruktur der Gesamtstruktur-Vertrauensstellung zusammen.

Syntax

DSGETDCAPI DWORD DsMergeForestTrustInformationW(
  [in]           LPCWSTR                       DomainName,
  [in]           PLSA_FOREST_TRUST_INFORMATION NewForestTrustInfo,
  [in, optional] PLSA_FOREST_TRUST_INFORMATION OldForestTrustInfo,
  [out]          PLSA_FOREST_TRUST_INFORMATION *MergedForestTrustInfo
);

Parameter

[in] DomainName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die die zu aktualisierende vertrauenswürdige Domäne angibt.

[in] NewForestTrustInfo

Zeiger auf eine LSA_FOREST_TRUST_INFORMATION-Struktur , die die neuen Daten zur Gesamtstrukturvertrauensstellung enthält, die zusammengeführt werden sollen. Die Flags - und Time-Member der Einträge werden ignoriert.

[in, optional] OldForestTrustInfo

Zeiger auf eine LSA_FOREST_TRUST_INFORMATION-Struktur , die die alten Daten zur Gesamtstrukturvertrauensstellung enthält, die zusammengeführt werden sollen. Dieser Parameter kann NULL sein, wenn keine Datensätze vorhanden sind.

[out] MergedForestTrustInfo

Zeiger auf einen LSA_FOREST_TRUST_INFORMATION Strukturzeiger, der die daten der zusammengeführten Gesamtstrukturvertrauensstellung empfängt.

Der Aufrufer muss diese Struktur freigeben, wenn sie nicht mehr benötigt wird, indem Er NetApiBufferFree aufruft.

Rückgabewert

Gibt NO_ERROR zurück, wenn erfolgreich oder ein Windows-Fehlercode andernfalls.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	dsgetdc.h
Bibliothek	Netapi32.lib
DLL	Netapi32.dll

Weitere Informationen

Verzeichnisdienstfunktionen

NetApiBufferFree