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
| Cliente mínimo com suporte | Windows XP com SP2, Windows Vista com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 com SP1 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | searchapi.h |
| Redistribuível | Windows Search (WS) 4.0 |