LsaQueryTrustedDomainInfo-Funktion (ntsecapi.h)

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

Weitere Informationen

LsaSetTrustedDomainInformation

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_LSA_SERVER_ROLE_INFO

POLICY_MODIFICATION_INFO

POLICY_PRIMARY_DOMAIN_INFO

TRUSTED_INFORMATION_CLASS