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

Recupera uma matriz de SIDs (identificadores de segurança do usuário) para uma URL especificada. Esse método permite que os manipuladores de protocolo especifiquem quais usuários podem acessar o arquivo e o host do protocolo de pesquisa para representar um usuário para indexar o arquivo.

Sintaxe

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

Parâmetros

[in] pcwszURL

Tipo: LPCWSTR

A URL a ser acessada em nome de um usuário representado.

[out] pcSidCount

Tipo: DWORD*

Recebe um ponteiro para o número de SIDs de usuário retornados em ppSidBlobs.

[out] ppSidBlobs

Tipo: BLOB**

Recebe o endereço de um ponteiro para a matriz de SIDs de usuário de representação do candidato.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se o arquivo for criptografado, esse método identificará quem pode descriptografá-lo e acessá-lo. Se o método não puder identificar essas informações, ele falhará com o código de erro E_ACCESSDENIED.

Esse método pressupõe que o objeto IUrlAccessor2 falhou ao inicializar e retornou o código PRTH_S_TRY_IMPERSONATING. Em seguida, o host do protocolo de pesquisa chama esse método para recuperar uma lista de SIDs a serem usados para representação e reverte para usar IUrlAccessor2, representando um dos usuários permitidos ao abrir o item.

Representar um usuário não eleva os privilégios do chamador. Se o chamador não puder recuperar diretamente a lista de usuários autorizados a acessar um recurso, o chamador também não poderá fazer isso com esse método. Somente o host do protocolo de pesquisa e o indexador têm privilégios adequados para representar usuários conectados no momento.

Requisitos

Confira também

IUrlAccessor3

IUrlAccessor4

Mensagens de erro do manipulador de protocolo de pesquisa