Méthode IUrlAccessor ::GetSecurityDescriptor (searchapi.h)
Obtient le descripteur de sécurité pour l’élément d’URL. La sécurité étant appliquée au moment de la requête, ce descripteur identifie la sécurité pour l’accès en lecture.
Syntaxe
HRESULT GetSecurityDescriptor(
[out] BYTE *pSD,
[in] DWORD dwSize,
[out] DWORD *pdwLength
);
Paramètres
[out] pSD
Type : BYTE*
Reçoit un pointeur vers le descripteur de sécurité.
[in] dwSize
Type : DWORD
Taille en TCHARdu tableau pSD .
[out] pdwLength
Type : DWORD*
Reçoit un pointeur vers le nombre de TCHARécrits dans pSD, sans la valeur NULL de fin.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Cette méthode permet des mappages personnalisés entre les utilisateurs inscrits à une source de contenu et ceux inscrits sur le domaine, s’ils sont différents. Les descripteurs de sécurité créés dans cette méthode doivent être auto-relatifs.
Si l’URL contient un identificateur de sécurité utilisateur (SID), le gestionnaire de protocole est appelé dans le contexte de sécurité de cet utilisateur, et cette méthode doit retourner E_NOTIMPL.
Si l’URL ne contient pas de SID utilisateur, le gestionnaire de protocole est appelé dans le contexte de sécurité du service système. Dans ce cas, cette méthode peut retourner une liste de contrôle d’accès (ACL) pour restreindre l’accès en lecture, ou PRTH_S_ACL_IS_READ_EVERYONE pour autoriser tout le monde à accéder en lecture pendant l’interrogation.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP avec SP2, Windows Vista [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 Desktop Search (WDS) 3.0 |