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.

[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

Consulte también

Página de propiedades de seguridad básica

ISecurityInformation