Compartir a través de


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

Obtiene el descriptor de seguridad para el elemento de dirección URL. La seguridad se aplica en el momento de la consulta, por lo que este descriptor identifica la seguridad para el acceso de lectura.

Sintaxis

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

Parámetros

[out] pSD

Tipo: BYTE*

Recibe un puntero al descriptor de seguridad.

[in] dwSize

Tipo: DWORD

Tamaño en TCHARs de la matriz pSD .

[out] pdwLength

Tipo: DWORD*

Recibe un puntero al número de TCHARescritos en pSD, no incluida la terminación NULL.

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

Este método permite asignaciones personalizadas entre los usuarios registrados en un origen de contenido y los usuarios registrados en el dominio, si son diferentes. Los descriptores de seguridad creados en este método deben ser auto-relativos.

Si la dirección URL contiene un identificador de seguridad de usuario (SID), el controlador de protocolo se invoca en el contexto de seguridad de ese usuario y este método debe devolver E_NOTIMPL.

Si la dirección URL no contiene un SID de usuario, se invoca al controlador de protocolo en el contexto de seguridad del servicio del sistema. En ese caso, este método puede devolver una lista de control de acceso (ACL) para restringir el acceso de lectura o PRTH_S_ACL_IS_READ_EVERYONE para permitir el acceso de lectura a cualquier persona durante la consulta.

Nota Si este método devuelve E_NOTIMPL y la dirección URL NO contiene un SID de usuario, todas las consultas de usuario pueden recuperar el elemento.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2, Windows Vista [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 Búsqueda de escritorio de Windows (WDS) 3.0

Consulte también

IUrlAccessor

Mensajes de error del controlador de protocolo de búsqueda