Edit

ISecurityCallersColl::get_Item method (comsvcs.h)

  • Article

Retrieves a specified caller in the security callers collection.

Syntax

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

Parameters

[in] lIndex

The name of the caller to retrieve. See Remarks for information about the available callers.

[out] pObj

A reference to the retrieved caller.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, and S_OK.

Remarks

The security callers collection represents a chain of callers that cross security boundaries. These callers are also known as upstream callers.

Each item in this collection is a SecurityIdentity object. To obtain an item in this collection, use the Item property of the SecurityCallers collection object, specifying an integer index value between 0 and the number of callers, minus 1, in the collection. To retrieve the direct caller, this index value should be 0, and to retrieve the original caller, the index can be either -1 or the number of callers minus 1.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header comsvcs.h

See also

ISecurityCallersColl