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

  • Artigo

O método GetSecondarySecurity retorna contextos de segurança adicionais que podem afetar o acesso ao recurso.

Sintaxe

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

Parâmetros

[out] pSecurityObjects

Uma matriz de estruturas SECURITY_OBJECT que contêm os objetos de segurança secundários associados aos recursos definidos com êxito. A matriz pertence ao chamador e é liberada usando a função LocalFree . O membro pwszName também é liberado usando LocalFree. Se os membros cbData ou cbData2 da estrutura SECURITY_OBJECT não forem zero, o chamador deverá liberar o pData ou pData2 correspondente usando LocalFree. Se um desses membros for zero, os membros pData e pData2 correspondentes pertencerão ao gerenciador de recursos e deverão permanecer válidos até que a função EditSecurity retorne

[out] pSecurityObjectCount

O número de objetos de segurança no parâmetro pSecurityObjects que são definidos com êxito.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK.

Se o método falhar, ele retornará um código de erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

Um gerenciador de recursos não precisa retornar objetos secundários com o membro fWellKnown definido como TRUE e o membro Id definido como SECURITY_OBJECT_ID_OBJECT_SD, SECURITY_OBJECT_ID_CENTRAL_POLICY ou SECURITY_OBJECT_ID_CENTRAL_ACCESS_RULE. Objetos de segurança com essas IDs serão fornecidos pelo editor de controle de acesso ao chamar ComputeEffectivePermissionWithSecondarySecurity.

A interpretação dos objetos de segurança retornados está vinculada à implementação de ComputeEffectivePermissionWithSecondarySecurity.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho aclui.h

Confira também

ISecurityInformation4