LsaQueryTrustedDomainInfoByName-Funktion (ntsecapi.h)

Artikel
08/25/2023

Die LsaQueryTrustedDomainInfoByName-Funktion gibt Informationen zu einer vertrauenswürdigen Domäne zurück.

Syntax

NTSTATUS LsaQueryTrustedDomainInfoByName(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PLSA_UNICODE_STRING       TrustedDomainName,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

Parameter

[in] PolicyHandle

Ein Handle für ein Policy-Objekt . Dieses Handle muss über das zugriffsrecht POLICY_VIEW_LOCAL_INFORMATION verfügen. Weitere Informationen finden Sie unter Öffnen eines Richtlinienobjekthandles.

[in] TrustedDomainName

Zeichenfolge, die den Namen der vertrauenswürdigen Domäne enthält. Dies kann entweder der Domänenname oder der Flatname sein.

[in] InformationClass

Gibt den Typ der abzurufenden Informationen an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
TrustedDomainNameInformation	Name der vertrauenswürdigen Domäne.
TrustedPosixInformation	Posix-Offset der vertrauenswürdigen Domäne.
TrustedPasswordInformation	Gibt das Kennwort auf der ausgehenden Seite der Vertrauensstellung zurück.
TrustedDomainInformationBasic	Dieser Wert wird nicht unterstützt.
TrustedDomainInformationEx	Erweiterte Vertrauensinformationen, einschließlich der grundlegenden Informationen, des DNS-Domänennamens und der Attribute zur Vertrauensstellung.
TrustedDomainFullInformation	Vollständige Informationen, einschließlich des Posix-Offsets und der Authentifizierungsinformationen.

[out] Buffer

Empfängt einen Zeiger auf den zurückgegebenen Puffer, der die angeforderten Informationen enthält. Format und Inhalt dieses Puffers hängen von der Informationsklasse ab. Wenn InformationClass beispielsweise auf TrustedDomainInformationEx festgelegt ist, empfängt Buffer einen Zeiger auf eine TRUSTED_DOMAIN_INFORMATION_EX-Struktur . Weitere Informationen finden Sie unter TRUSTED_INFORMATION_CLASS.

Wenn Sie die Verwendung des Puffers abgeschlossen haben, geben Sie ihn frei, indem Sie die LsaFreeMemory-Funktion aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion STATUS_SUCCESS zurück.

Wenn die Funktion fehlschlägt, gibt sie einen NTSTATUS-Wert zurück, 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. Eine Liste der erforderlichen Zugriffstypen finden Sie in der Beschreibung des InformationClass-Parameters .
STATUS_INSUFFICIENT_ RESSOURCEN	Unzureichende Systemressourcen, z. B. Arbeitsspeicher, um den Aufruf abzuschließen.

Sie können die LsaNtStatusToWinError-Funktion verwenden, um den NTSTATUS-Wert 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

LsaFreeMemory

LsaQueryTrustedDomainInfo

LsaSetTrustedDomainInfoByName

TRUSTED_DOMAIN_INFORMATION_EX

TRUSTED_INFORMATION_CLASS

Freigeben über