Función DSCreateISecurityInfoObjectEx (dssec.h)

  • Artículo

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

Sintaxis

HRESULT DSCreateISecurityInfoObjectEx(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           LPCWSTR                pwszServer,
  [in]           LPCWSTR                pwszUserName,
  [in]           LPCWSTR                pwszPassword,
  [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] pwszServer

Servidor del objeto especificado por el parámetro pwszObjectPath . Si el valor de este parámetro es NULL, el servidor se obtiene de la ruta de acceso especificada por el parámetro pwszObjectPath .

[in] pwszUserName

Nombre de usuario que se va a asociar al nuevo objeto ISecurityInformation . Si el valor de este parámetro es NULL, se usa el valor predeterminado interfaces de Servicios de Active Directory (ADSI).

[in] pwszPassword

Contraseña que se va a asociar al nuevo objeto ISecurityInformation . Si el valor de este parámetro es NULL, se usa el valor predeterminado interfaces de Servicios de Active Directory (ADSI).

[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