LsaQueryTrustedDomainInfoByName-Funktion (ntsecapi.h)

  • Artikel

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