Méthode ISecurityIdentityColl ::get_Item (comsvcs.h)
Récupère une propriété spécifiée dans la collection d’identités de sécurité.
Syntaxe
HRESULT get_Item(
[in] BSTR name,
[out] VARIANT *pItem
);
Paramètres
[in] name
Nom de la propriété à récupérer. Pour plus d’informations sur les propriétés disponibles, consultez Remarques.
[out] pItem
Référence à la propriété récupérée.
Valeur retournée
Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL et S_OK.
Remarques
Cette collection représente une identité de sécurité, qui fournit des informations sur un appelant particulier dans la chaîne d’appels se terminant par l’appel actuel. Pour chaque élément de la collection d’identités de sécurité, le tableau suivant fournit une description, le nom d’index utilisé pour le récupérer et le type de données retourné de l’élément.
| Élément | Description | Nom d’index | Type retourné |
|---|---|---|---|
| SID | Identificateur de sécurité de l’appelant. | « SID » | V_ARRAY |
| Nom du compte | Nom du compte utilisé par l’appelant. | « AccountName » | V_BSTR |
| Service d’authentification | Service d’authentification utilisé par l’appelant, tel que NTLMSSP, Kerberos ou SSL. | « AuthenticationService » | V_I4 |
| Niveau d’emprunt d’identité | Le niveau d’emprunt d’identité, qui indique l’autorité accordée à l’appelant pour agir au nom d’un client. | « ImpersonationLevel » | V_I4 |
| Niveau d’authentification | Niveau d’authentification utilisé par l’appelant, qui indique le niveau de protection donné pendant l’appel. | « AuthenticationLevel » | V_I4 |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | comsvcs.h |