LsaOpenTrustedDomainByName-Funktion (ntsecapi.h)

Artikel
02/29/2024

Die LsaOpenTrustedDomainByName-Funktion öffnet das LSA-Richtlinienhandle einer vertrauenswürdigen Remotedomäne. Sie können dieses Handle an LSA-Funktionsaufrufe übergeben, um die LSA-Richtlinie des Remotecomputers festzulegen oder abzufragen.

Syntax

NTSTATUS LsaOpenTrustedDomainByName(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING TrustedDomainName,
  [in]  ACCESS_MASK         DesiredAccess,
  [out] PLSA_HANDLE         TrustedDomainHandle
);

Parameter

[in] PolicyHandle

Ein Handle für ein Policy-Objekt . Dies ist der Richtlinienhandle des lokalen Computers. Weitere Informationen finden Sie unter Öffnen eines Richtlinienobjekthandles.

[in] TrustedDomainName

Name der vertrauenswürdigen Domäne. Dieser Name kann entweder der flache Name oder der DNS-Domänenname (Domain Name System) sein.

[in] DesiredAccess

Eine ACCESS_MASK-Struktur , die die Zugriffsberechtigungen angibt, die für das Remoteobjekt der vertrauenswürdigen Remotedomäne angefordert werden.

[out] TrustedDomainHandle

Zeiger, der die Adresse des LSA-Richtlinienhandles der vertrauenswürdigen Remotedomäne empfängt. Sie können dieses Handle an LSA-Funktionsaufrufe übergeben, um die LSA-Richtlinie des Remotecomputers abzufragen und zu verwalten.

Wenn Ihre Anwendung dieses Handle nicht mehr benötigt, sollte sie LsaClose aufrufen, um das Handle zu löschen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein NTSTATUS-Code, der einer der folgenden Werte oder einer der Rückgabewerte der LSA-Richtlinienfunktion sein kann.

Wert	BESCHREIBUNG
STATUS_ACCESS_DENIED	Der Aufrufer verfügt nicht über den entsprechenden Zugriff, um den Vorgang abzuschließen.
STATUS_OBJECT_NAME_NOT_FOUND	Es gibt kein vertrauenswürdiges Domänenobjekt in der LSA-Datenbank des Zielsystems mit dem angegebenen Namen.

Sie können die LsaNtStatusToWinError-Funktion verwenden, um den NTSTATUS-Code in einen Windows-Fehlercode zu konvertieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntsecapi.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

LsaClose

Freigeben über