IAzApplication::InitializeClientContextFromName-Methode (azroles.h)

Artikel
02/26/2024

Die InitializeClientContextFromName-Methode ruft einen IAzClientContext-Objektzeiger aus der Clientidentität als Paar (Domänenname, Clientname) ab.

Hinweis Rufen Sie nach Möglichkeit die InitializeClientContextFromToken-Funktion anstelle von InitializeClientContextFromName auf. Weitere Informationen finden Sie in den Hinweisen.

Syntax

HRESULT InitializeClientContextFromName(
  [in]           BSTR             ClientName,
  [in, optional] BSTR             DomainName,
  [in, optional] VARIANT          varReserved,
  [out]          IAzClientContext **ppClientContext
);

Parameter

[in] ClientName

Name des Sicherheitsprinzipals.

[in, optional] DomainName

Domänenname, in dem sich das Benutzerkonto befindet. Der Standardwert ist NULL.

[in, optional] varReserved

Für die zukünftige Verwendung reserviert. Dieser Parameter kann einer der folgenden Werte sein:

varReserved.vt == VT_ERROR und varReserved.scode == DISP_E_PARAMNOTFOUND
varReserved.vt == VT_EMPTY
varReserved.vt == VT_NULL
varReserved.vt == VT_I4 und varReserved.lVal == 0
varReserved.vt == VT_I2 und varReserved.iVal == 0

[out] ppClientContext

Ein Zeiger auf einen Zeiger auf das zurückgegebene IAzClientContext-Objekt .

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Rufen Sie nach Möglichkeit die InitializeClientContextFromToken-Funktion anstelle von InitializeClientContextFromName auf. InitializeClientContextFromName versucht, die in einem Anmeldetoken verfügbaren Informationen abzurufen, wenn der Client tatsächlich angemeldet war. Ein tatsächliches Anmeldetoken bietet weitere Informationen, z. B. Anmeldetyp und Anmeldeeigenschaften, und spiegelt das Verhalten des für die Anmeldung verwendeten Authentifizierungspakets wider. Der von InitializeClientContextFromToken erstellte Clientkontext verwendet ein Anmeldetoken, und der resultierende Clientkontext ist vollständiger und genauer als ein von InitializeClientContextFromName erstellter Clientkontext.

Die Parameter DomainName und ClientName müssen kombiniert werden, um einen SidTypeUser darzustellen.

Die unterstützten Namensformate sind identisch mit denen, die von der LookupAccountName-Funktion unterstützt werden.

Wichtig Anwendungen sollten nicht davon ausgehen, dass der aufrufende Kontext über die Berechtigung zur Verwendung dieser Funktion verfügt. Die AuthzInitializeContextFromSid-Funktion liest das Attribut tokenGroupsGlobalAndUniversal der im Aufruf angegebenen SID, um die Gruppenmitgliedschaften des aktuellen Benutzers zu bestimmen. Wenn sich das Objekt des Benutzers in Active Directory befindet, muss der aufrufende Kontext über Lesezugriff auf das Attribut tokenGroupsGlobalAndUniversal für das Benutzerobjekt verfügen. Lesezugriff auf das Attribut tokenGroupsGlobalAndUniversal wird der Gruppe Pre-Windows 2000 Compatible Access gewährt, aber neue Domänen enthalten standardmäßig eine leere Pre-Windows 2000 Compatible Access-Gruppe , da die Standardeinrichtungsauswahl Berechtigungen ist, die mit Windows 2000 und Windows Server 2003 kompatibel sind. Daher haben Anwendungen möglicherweise keinen Zugriff auf das Attribut tokenGroupsGlobalAndUniversal. In diesem Fall schlägt die AuthzInitializeContextFromSid-Funktion mit ACCESS_DENIED fehl. Anwendungen, die diese Funktion verwenden, sollten diesen Fehler ordnungsgemäß behandeln und unterstützende Dokumentation bereitstellen. Um zu vereinfachen, konten die Berechtigung zum Abfragen der Gruppeninformationen eines Benutzers zu gewähren, fügen Sie Konten hinzu, die die Möglichkeit benötigen, Gruppeninformationen zur Windows-Autorisierungszugriffsgruppe nachzuschlagen.

Anwendungen, die diese Funktion aufrufen, sollten den vollqualifizierten Domänennamen oder Benutzerprinzipalnamen (UPN) verwenden. Andernfalls kann diese Methode gesamtstrukturübergreifend fehlschlagen, wenn der NetBIOS-Domänenname verwendet wird und die beiden Domänen keine direkte Vertrauensstellung haben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	azroles.h
Bibliothek	Azroles.lib
DLL	Azroles.dll
Verteilbare Komponente	Windows Server 2003 Administration Tools Pack unter Windows XP

Weitere Informationen

Zulassen des anonymen Zugriffs

IAzApplication

Freigeben über