LsaQueryTrustedDomainInfo-Funktion (ntsecapi.h)

Artikel
08/25/2023

Die LsaQueryTrustedDomainInfo-Funktion ruft Informationen zu einer vertrauenswürdigen Domäne ab.

Syntax

NTSTATUS LsaQueryTrustedDomainInfo(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PSID                      TrustedDomainSid,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

Parameter

[in] PolicyHandle

Ein Handle für das Policy-Objekt eines Domänencontrollers, der über eine Vertrauensstellung mit der Domäne verfügt, die durch den TrustedDomainSid-Parameter identifiziert wird. Das Handle muss über das zugriffsrecht POLICY_VIEW_LOCAL_INFORMATION verfügen. Weitere Informationen finden Sie unter Öffnen eines Richtlinienobjekthandles.

[in] TrustedDomainSid

Zeiger auf die SID der abzufragenden vertrauenswürdigen Domäne.

[in] InformationClass

Gibt einen der folgenden Werte aus dem TRUSTED_INFORMATION_CLASS-Enumerationstyp an. Der Wert gibt den Typ der angeforderten Informationen an.

Wert	Bedeutung
TrustedDomainNameInformation	Ruft den Namen der vertrauenswürdigen Domäne ab. Der Buffer-Parameter empfängt einen Zeiger auf eine TRUSTED_DOMAIN_NAME_INFO-Struktur .
TrustedPosixOffsetInformation	Ruft den Wert ab, der zum Generieren von Posix-Benutzer- und Gruppenbezeichnern für die vertrauenswürdige Domäne verwendet wird. Der Parameter Buffer empfängt einen Zeiger auf eine TRUSTED_POSIX_OFFSET_INFO-Struktur .
TrustedPasswordInformation	Ruft das Kennwort für die vertrauenswürdige Domäne ab. Der Buffer-Parameter empfängt einen Zeiger auf eine TRUSTED_PASSWORD_INFO-Struktur . Das im Parameter PolicyHandle übergebene Handle muss über das zugriffsrecht POLICY_GET_PRIVATE_INFORMATION verfügen.
TrustedDomainInformationEx	Ruft erweiterte Informationen für die vertrauenswürdige Domäne ab. Der Buffer-Parameter empfängt einen Zeiger auf eine TRUSTED_DOMAIN_INFORMATION_EX-Struktur .
TrustedDomainInformationBasic	Dieser Wert wird nicht unterstützt.
TrustedDomainFullInformation	Ruft vollständige Informationen für die vertrauenswürdige Domäne ab. Diese Informationen umfassen die Posix-Offsetinformationen, Authentifizierungsinformationen und die erweiterten Informationen, die für den TrustedDomainInformationEx-Wert zurückgegeben werden. Der Buffer-Parameter empfängt einen Zeiger auf eine TRUSTED_DOMAIN_FULL_INFORMATION-Struktur .

[out] Buffer

Ein Zeiger auf einen Puffer, der einen Zeiger auf eine Struktur empfängt, die die angeforderten Informationen enthält. Der Typ der Struktur hängt vom Wert des InformationClass-Parameters ab.

Wenn Sie die Verwendung der Informationen abgeschlossen haben, geben Sie den zurückgegebenen Zeiger frei, indem Sie ihn an LsaFreeMemory übergeben.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird ein NTSTATUS-Wert zurückgegeben, der den Fehler angibt. Weitere Informationen finden Sie unter Rückgabewerte der LSA-Richtlinienfunktion.

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