Función DSCreateSecurityPage (dssec.h)

  • Artículo

La función DSCreateSecurityPage crea una página de propiedades de seguridad para un objeto de Active Directory. La página de propiedades resultante se puede agregar a una hoja de propiedades.

Sintaxis

HRESULT DSCreateSecurityPage(
  [in]           LPCWSTR                pwszObjectPath,
  [in, optional] LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          HPROPSHEETPAGE         *phPage,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Parámetros

[in] pwszObjectPath

Puntero a una cadena de caracteres anchos terminada en NULL que representa la ruta de acceso completa de Active Directory para el objeto.

[in, optional] pwszObjectClass

Puntero a una cadena de caracteres anchos terminada en NULL que representa la clase de objeto. Este valor puede ser NULL.

[in] dwFlags

Marcas usadas para la página de propiedades de seguridad. Este parámetro puede ser ninguno o 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 la 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] phPage

Puntero a un HPROPSHEETPAGE que devuelve la página de propiedades de seguridad creada.

[in, optional] pfnReadSD

Puntero a una función usada para leer el descriptor de seguridad del objeto. Este valor puede ser NULL. Si pfnReadSD no es NULL, DSCreateSecurityPage 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 que se usa para escribir el descriptor de seguridad del objeto. Este valor puede ser NULL. Si pfnWriteSD no es NULL, DSCreateSecurityPage 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 pfnReadSD o 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.

Comentarios

La función a la que apunta pfnReadSD se define como se indica a continuación.

#include <windows.h>

typedef HRESULT (WINAPI *PFNREADOBJECTSECURITY)(
    LPCWSTR,               // Active Directory path of object
    SECURITY_INFORMATION,  // the security information to read
    PSECURITY_DESCRIPTOR*, // the returned security descriptor 
    LPARAM                 // context parameter
);

La función DSCreateSecurityPage liberará el descriptor de seguridad devuelto en el tercer parámetro anterior mediante una llamada a la función LocalFree .

La función a la que apunta pfnWriteSD se define como se indica a continuación.

#include <windows.h>

typedef HRESULT (WINAPI *PFNWRITEOBJECTSECURITY)(
    LPCWSTR,              // Active Directory path of object
    SECURITY_INFORMATION, // the security information to write
    PSECURITY_DESCRIPTOR, // the security descriptor to write
    LPARAM                // context parameter
);

Requisitos

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

Consulte también

Página de propiedades de seguridad básica

ISecurityInformation