Función DSCreateISecurityInfoObject (dssec.h)

La función DSCreateISecurityInfoObject crea una instancia de la interfaz ISecurityInformation asociada al objeto de servicio de directorio (DS) especificado.

Sintaxis

HRESULT DSCreateISecurityInfoObject(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          LPSECURITYINFO         *ppSI,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Parámetros

[in] pwszObjectPath

Ruta de acceso completa del objeto DS para el que se va a crear una instancia de la interfaz ISecurityInformation .

[in] pwszObjectClass

Clase del objeto especificado por el parámetro pwszObjectPath .

[in] dwFlags

Marcas usadas para la página de propiedades de seguridad asociada a la nueva instancia de la interfaz ISecurityInformation . Este parámetro puede ser cualquier combinación de las marcas siguientes.

Valor Significado
DSSI_READ_ONLY
0x00000001
Las propiedades de seguridad son de solo lectura.
DSSI_NO_ACCESS_CHECK
0x00000002
No se realiza ninguna comprobación de acceso.
DSSI_NO_EDIT_SACL
0x00000004
La propiedad de lista de control de acceso del sistema (SACL) es de solo lectura.
DSSI_NO_EDIT_OWNER
0x00000008
La propiedad del propietario del objeto es de solo lectura.
DSSI_IS_ROOT
0x00000010
El objeto es un objeto raíz.
DSSI_NO_FILTER
0x00000020
No aplique ningún filtro.
DSSI_NO_READONLY_MESSAGE
0x00000040
Suprima los mensajes emergentes de solo lectura.

[out] ppSI

Puntero a la instancia de la interfaz ISecurityInformation que crea esta función.

[in, optional] pfnReadSD

Puntero a una función utilizada para leer el descriptor de seguridad del objeto. Este valor puede ser NULL. Si pfnReadSD no es NULL, DSCreateISecurityInfoObject llama a la función a la que hace referencia pfnReadSD para recuperar el descriptor de seguridad del objeto.

[in, optional] pfnWriteSD

Puntero a una función usada para escribir el descriptor de seguridad del objeto. Este valor puede ser NULL. Si pfnWriteSD no es NULL, DSCreateISecurityInfoObject llama a la función a la que hace referencia pfnWriteSD para escribir el descriptor de seguridad del objeto.

[in] lpContext

Contexto para pasar a las funciones identificadas por los parámetros pfnReadSD y pfnWriteSD .

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Requisitos

   
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado dssec.h
Library DSSec.lib
Archivo DLL DSSec.dll