Método ISecurityInformation4::GetSecondarySecurity (aclui.h)

El método GetSecondarySecurity devuelve contextos de seguridad adicionales que pueden afectar al acceso al recurso.

Sintaxis

HRESULT GetSecondarySecurity(
  [out] PSECURITY_OBJECT *pSecurityObjects,
  [out] PULONG           pSecurityObjectCount
);

Parámetros

[out] pSecurityObjects

Matriz de estructuras de SECURITY_OBJECT que contienen los objetos de seguridad secundarios asociados a los recursos que se establecen correctamente. La matriz es propiedad del autor de la llamada y se libera mediante la función LocalFree . El miembro pwszName también se libera mediante LocalFree. Si los miembros cbData o cbData2 de la estructura SECURITY_OBJECT no son cero, el autor de la llamada debe liberar el pData o pData2 correspondiente mediante LocalFree. Si alguno de esos miembros es cero, los miembros pData y pData2 correspondientes son propiedad del administrador de recursos y deben permanecer válidos hasta que se devuelva la función EditSecurity .

[out] pSecurityObjectCount

Número de objetos de seguridad del parámetro pSecurityObjects que se establecen correctamente.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK.

Si el método genera un error, este método devuelve un código de error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

Un administrador de recursos no necesita devolver objetos secundarios con el miembro fWellKnown establecido en TRUE y el miembro Id establecido en SECURITY_OBJECT_ID_OBJECT_SD, SECURITY_OBJECT_ID_CENTRAL_POLICY o SECURITY_OBJECT_ID_CENTRAL_ACCESS_RULE. El editor de control de acceso proporcionará objetos de seguridad con estos identificadores al llamar a ComputeEffectivePermissionWithSecondarySecurity.

La interpretación de los objetos de seguridad devueltos está vinculada a la implementación de ComputeEffectivePermissionWithSecondarySecurity.

Requisitos

Consulte también

ISecurityInformation4