AtlGetSecurityDescriptor

Chamar essa função para recuperar o descritor de segurança de um determinado objeto.

Importante
Essa função não pode ser usada em aplicativos executados em Tempo de Execução do Windows.

inline bool AtlGetSecurityDescriptor(
LPCTSTR pszObjectName,
SE_OBJECT_TYPE ObjectType,
CSecurityDesc * pSecurityDescriptor,
SECURITY_INFORMATION requestedInfo= OWNER_SECURITY_INFORMATION | 
GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION | 
SACL_SECURITY_INFORMATION,
bool bRequestNeededPrivileges= true
) throw(...);

Parâmetros

• pszObjectName
  Ponteiro para uma cadeia de caracteres NULL- finalizada que especifica o nome do objeto que para recuperar informações de segurança.

• ObjectType
  Especifica um valor de enumeração de SE_OBJECT_TYPE que indica o tipo de objeto identificado pelo parâmetro do pszObjectName .

• pSecurityDescriptor
  O objeto que recebe o descritor de segurança aplicativo.

• requestedInfo
  Um conjunto de sinalizadores de bit de SECURITY_INFORMATION indicando o tipo de informações de segurança para recuperar.Este parâmetro pode ser uma combinação dos seguintes valores.

• bRequestNeededPrivileges
  Se verdadeiro, a função tentará ativar o privilégio de SE_SECURITY_NAME, e restaurar-lo na conclusão.

Valor de retorno

Retorna verdadeiros em êxito, falso em caso de falha.

Comentários

Se AtlGetSecurityDescriptor deve ser chamado várias vezes em vários objetos diferentes, será mais eficiente ativar uma vez do privilégio SE_SECURITY_NAME antes de chamar a função, com bRequestNeededPrivileges definido como false.

Requisitos

Cabeçalho: atlsecurity.h

Consulte também

Outros recursos

Funções de segurança globais