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.
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 |