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 |