Méthode IUrlAccessor3::GetImpersonationSidBlobs (searchapi.h)

Récupère un tableau d’identificateurs de sécurité utilisateur (SID) pour une URL spécifiée. Cette méthode permet aux gestionnaires de protocoles de spécifier quels utilisateurs peuvent accéder au fichier et à l’hôte du protocole de recherche pour emprunter l’identité d’un utilisateur afin d’indexer le fichier.

Syntaxe

HRESULT GetImpersonationSidBlobs(
  [in]  LPCWSTR pcwszURL,
  [out] DWORD   *pcSidCount,
  [out] BLOB    **ppSidBlobs
);

Paramètres

[in] pcwszURL

Type : LPCWSTR

URL à accéder pour le compte d’un utilisateur qui emprunte l’identité.

[out] pcSidCount

Type : DWORD*

Reçoit un pointeur vers le nombre de SID utilisateur retournés dans ppSidBlobs.

[out] ppSidBlobs

Type : BLOB**

Reçoit l’adresse d’un pointeur vers le tableau des SID d’utilisateurs d’emprunt d’identité candidats.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Si le fichier est chiffré, cette méthode identifie qui peut à la fois le déchiffrer et y accéder. Si la méthode ne peut pas identifier ces informations, elle échoue avec le code d’erreur E_ACCESSDENIED.

Cette méthode suppose que l’objet IUrlAccessor2 n’a pas pu s’initialiser et a retourné le code PRTH_S_TRY_IMPERSONATING. Ensuite, l’hôte du protocole de recherche appelle cette méthode pour récupérer une liste de SID à utiliser pour l’emprunt d’identité et revient à l’utilisation d’IUrlAccessor2, empruntant l’identité de l’un des utilisateurs autorisés lors de l’ouverture de l’élément.

L’emprunt d’identité d’un utilisateur n’élève pas les privilèges de l’appelant. Si l’appelant ne peut pas récupérer directement la liste des utilisateurs autorisés à accéder à une ressource, l’appelant ne pourra pas non plus le faire avec cette méthode. Seuls l’hôte du protocole de recherche et l’indexeur disposent des privilèges adéquats pour emprunter l’identité des utilisateurs actuellement connectés.

Spécifications

Client minimal pris en charge	Windows XP avec SP2, Windows Vista avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	searchapi.h
Composant redistribuable	Windows Search (WS) 4.0

Voir aussi

IUrlAccessor3

IUrlAccessor4

Messages d’erreur du gestionnaire de protocole de recherche