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

Consulte también

IUrlAccessor3

IUrlAccessor4

Mensajes de error del controlador del protocolo de búsqueda