Método IUrlAccessor::GetSecurityDescriptor (searchapi.h)

Obtém o descritor de segurança para o item de URL. A segurança é aplicada no momento da consulta, portanto, esse descritor identifica a segurança para acesso de leitura.

Sintaxe

HRESULT GetSecurityDescriptor(
  [out] BYTE  *pSD,
  [in]  DWORD dwSize,
  [out] DWORD *pdwLength
);

Parâmetros

[out] pSD

Tipo: BYTE*

Recebe um ponteiro para o descritor de segurança.

[in] dwSize

Tipo: DWORD

Tamanho em TCHARs da matriz pSD .

[out] pdwLength

Tipo: DWORD*

Recebe um ponteiro para o número de TCHARgravadosno pSD, não incluindo o NULL de terminação.

Retornar valor

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

Esse método permite mapeamentos personalizados entre usuários registrados em uma fonte de conteúdo e os usuários registrados no domínio, se forem diferentes. Os descritores de segurança criados nesse método devem ser auto-relativos.

Se a URL contiver um SID (identificador de segurança do usuário), o manipulador de protocolo será invocado no contexto de segurança desse usuário e esse método deverá retornar E_NOTIMPL.

Se a URL não contiver um SID de usuário, o manipulador de protocolo será invocado no contexto de segurança do serviço do sistema. Nesse caso, esse método pode retornar uma ACL (lista de controle de acesso) para restringir o acesso de leitura ou PRTH_S_ACL_IS_READ_EVERYONE permitir acesso de leitura a qualquer pessoa durante a consulta.

Nota Se esse método retornar E_NOTIMPL e a URL não contiver um SID de usuário, o item poderá ser recuperado por todas as consultas de usuário.

 

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [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	Pesquisa da Área de Trabalho do Windows (WDS) 3.0

Confira também

IUrlAccessor

Mensagens de erro do manipulador de protocolo de pesquisa