Partilhar via


AtlGetSecurityDescriptor

telefonar Esta função para recuperar o descritor de segurança de um determinado objeto.

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 seqüência de caracteres terminada com nulo que especifica o nome do objeto do qual recuperar informações de segurança.

  • ObjectType
    Especifica um valor a partir de SE_OBJECT_TYPE enumeração que indica o tipo de objeto que possui o pszObjectName parâmetro.

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

  • requestedInfo
    Um conjunto de SECURITY_INFORMATION bit sinalizadores que indicam o tipo de informação 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 SE_SECURITY_NAME e restaurá-lo após a conclusão.

Valor de retorno

Retorna verdadeiro sucesso, false em caso de falha.

Comentários

If AtlGetSecurityDescriptor deve ser chamado várias vezes em muitos objetos diferentes, será mais eficiente para habilitar o privilégio SE_SECURITY_NAME uma vez antes de chamar a função com bRequestNeededPrivileges conjunto para false.

Requisitos

Cabeçalho: atlsecurity.h

Consulte também

Outros recursos

Segurança funções global