Compartilhar via


Método ISecurityCallersColl::get_Item (comsvcs.h)

Recupera um chamador especificado na coleção de chamadores de segurança.

Sintaxe

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

Parâmetros

[in] lIndex

O nome do chamador a ser recuperado. Consulte Comentários para obter informações sobre os chamadores disponíveis.

[out] pObj

Uma referência ao chamador recuperado.

Retornar valor

Esse método pode retornar os valores retornados padrão E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL e S_OK.

Comentários

A coleção de chamadores de segurança representa uma cadeia de chamadores que ultrapassam os limites de segurança. Esses chamadores também são conhecidos como chamadores upstream.

Cada item nesta coleção é um objeto SecurityIdentity . Para obter um item nesta coleção, use a propriedade Item do objeto da coleção SecurityCallers , especificando um valor de índice inteiro entre 0 e o número de chamadores, menos 1, na coleção. Para recuperar o chamador direto, esse valor de índice deve ser 0 e, para recuperar o chamador original, o índice pode ser -1 ou o número de chamadores menos 1.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho comsvcs.h

Confira também

ISecurityCallersColl