IGetSecurityCallContext::GetSecurityCallContext-Methode (comsvcs.h)

Ruft einen Verweis auf ein Objekt ab, das aus der SecurityCallContext-Klasse erstellt wurde, die dem aktuellen Aufruf zugeordnet ist.

Anstatt diese Methode zu verwenden, sollten C++-Entwickler die CoGetCallContext-Funktion verwenden und IID_ISecurityCallContext für den riid-Parameter bereitstellen.

Syntax

HRESULT GetSecurityCallContext(
  [out] ISecurityCallContext **ppObject
);

Parameter

[out] ppObject

Ein Verweis auf ISecurityCallContext im Kontext des Objekts.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED und E_FAIL sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich abgeschlossen.
CONTEXT_E_NOCONTEXT
Dem aktuellen Objekt ist kein Kontext zugeordnet, da entweder die Komponente nicht in eine Anwendung importiert wurde oder das Objekt nicht mit einer der CREATEInstance-Methoden von COM+ erstellt wurde. Dieser Fehler wird auch zurückgegeben, wenn die GetObjectContext-Methode von einem Konstruktor oder von einer IUnknown-Methode aufgerufen wurde.

Hinweise

Mit dem Sicherheitsaufrufkontext eines Objekts können Sie Elemente aus der Sicherheitsaufrufkontextauflistung abrufen, z. B. die mindeste Authentifizierungsebene, den direkten Aufrufer, den ursprünglichen Aufrufer, die Kette der Aufrufer und die Anzahl der Aufrufer. Sie können auch die Methoden IsSecurityEnabled und IsCallerInRole aufrufen, um sicherzustellen, dass ein bestimmter Codeabschnitt ausgeführt wird. Sie können diese Methoden jedoch nur aufrufen, wenn die rollenbasierte Sicherheit aktiviert ist und der direkte Aufrufer Mitglied einer angegebenen Rolle ist.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile comsvcs.h

Weitere Informationen

COM+-Kontexte und Threadingmodelle

CoGetCallContext

IGetSecurityCallContext

ISecurityCallContext