Función DSCreateSecurityPage (dssec.h)
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 |
|---|---|
|
Las propiedades de seguridad son de solo lectura. |
|
No se realiza ninguna comprobación de acceso. |
|
La propiedad de la lista de control de acceso del sistema (SACL) es de solo lectura. |
|
La propiedad del propietario del objeto es de solo lectura. |
|
El objeto es un objeto raíz. |
|
No aplique ningún filtro. |
|
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 |