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 |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
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 |