ISecurityCallersColl::get_Item-Methode (comsvcs.h)

Ruft einen angegebenen Aufrufer in der Auflistung sicherheitsrelevanter Aufrufer ab.

Syntax

HRESULT get_Item(
  [in]  long                  lIndex,
  [out] ISecurityIdentityColl **pObj
);

Parameter

[in] lIndex

Der Name des abzurufenden Aufrufers. Informationen zu den verfügbaren Anrufern finden Sie unter Hinweise.

[out] pObj

Ein Verweis auf den abgerufenen Aufrufer.

Rückgabewert

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

Hinweise

Die Auflistung von Sicherheitsaufrufern stellt eine Kette von Aufrufern dar, die Sicherheitsgrenzen überschreiten. Diese Aufrufer werden auch als Upstream-Aufrufer bezeichnet.

Jedes Element in dieser Auflistung ist ein SecurityIdentity-Objekt . Verwenden Sie zum Abrufen eines Elements in dieser Auflistung die Item-Eigenschaft des SecurityCallers-Auflistungsobjekts , und geben Sie einen ganzzahligen Indexwert zwischen 0 und der Anzahl der Aufrufer (minus 1) in der Auflistung an. Um den direkten Aufrufer abzurufen, sollte dieser Indexwert 0 sein, und um den ursprünglichen Aufrufer abzurufen, kann der Index entweder -1 oder die Anzahl der Aufrufer minus 1 sein.

Anforderungen

Anforderung Wert
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

ISecurityCallersColl