Método IUrlAccessor3::GetImpersonationSidBlobs (searchapi.h)
Recupera una matriz de identificadores de seguridad de usuario (SID) para una dirección URL especificada. Este método permite a los controladores de protocolo especificar qué usuarios pueden acceder al archivo y al host del protocolo de búsqueda para suplantar a un usuario para indexar el archivo.
Sintaxis
HRESULT GetImpersonationSidBlobs(
[in] LPCWSTR pcwszURL,
[out] DWORD *pcSidCount,
[out] BLOB **ppSidBlobs
);
Parámetros
[in] pcwszURL
Tipo: LPCWSTR
Dirección URL a la que se va a acceder en nombre de un usuario suplantado.
[out] pcSidCount
Tipo: DWORD*
Recibe un puntero al número de SID de usuario devueltos en ppSidBlobs.
[out] ppSidBlobs
Tipo: BLOB**
Recibe la dirección de un puntero a la matriz de SID de usuario de suplantación candidata.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Si el archivo está cifrado, este método identifica quién puede descifrarlo y acceder a él. Si el método no puede identificar esta información, se produce un error en el código de error E_ACCESSDENIED.
Este método supone que el objeto IUrlAccessor2 no pudo inicializar y devolver el código PRTH_S_TRY_IMPERSONATING. A continuación, el host del protocolo de búsqueda llama a este método para recuperar una lista de SID que se van a usar para la suplantación y se revierte al uso de IUrlAccessor2, suplantando a uno de los usuarios permitidos al abrir el elemento.
Suplantar a un usuario no eleva los privilegios del autor de la llamada. Si el autor de la llamada no puede recuperar directamente la lista de usuarios autorizados para acceder a un recurso, el autor de la llamada tampoco podrá hacerlo con este método. Solo el host del protocolo de búsqueda y el indexador tienen privilegios adecuados para suplantar a los usuarios que han iniciado sesión actualmente.
Requisitos
| Cliente mínimo compatible | Windows XP con SP2, Windows Vista con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | searchapi.h |
| Redistribuible | Windows Search (WS) 4.0 |