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.

[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