Compartilhar via


CSecurityDesc::ToString

Converte um descritor de segurança em um formato de cadeia de caracteres.

bool ToString(
   CString * pstr,
   SECURITY_INFORMATION si = OWNER_SECURITY_INFORMATION | 
      GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION | 
      SACL_SECURITY_INFORMATION 
) const throw(...);

Parâmetros

  • pstr
    Ponteiro para uma cadeia de caracteres NULL- finalizada que recebe descritor de segurança cadeia de caracteres de formato.

  • si
    Especifica uma combinação de sinalizadores de bit de SECURITY_INFORMATION para indicar os componentes de descritor de segurança para incluir na cadeia de caracteres de saída.

Valor de retorno

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

Comentários

Uma vez que o descritor de segurança está no formato de cadeia de caracteres, pode ser mais facilmente armazenado ou passado.Use o método de CSecurityDesc::FromString para converter uma cadeia de caracteres de novo em um descritor de segurança.

O parâmetro de si pode conter os seguintes sinalizações de SECURITY_INFORMATION:

Valor

Significado

OWNER_SECURITY_INFORMATION

Inclua o proprietário.

GROUP_SECURITY_INFORMATION

Inclua o grupo primária.

DACL_SECURITY_INFORMATION

Inclua DACL.

SACL_SECURITY_INFORMATION

Inclua o SACL.

Se DACL é NULL e o bit de controle de SE_DACL_PRESENT é definido no descritor de segurança de entrada, o método falhar.

Se DACL é NULL e o bit de controle de SE_DACL_PRESENT não está definido no descritor de segurança de entrada, a cadeia de caracteres de descritor de segurança resultante não tiver um De: componente.Consulte Formato de cadeia de caracteres de descritor de segurança para obter mais detalhes.

Este método está disponível somente no Windows 2000 e posterior, porque chama ConvertStringSecurityDescriptorToSecurityDescriptor.

Requisitos

Cabeçalho: atlsecurity.h

Consulte também

Referência

Classe de CSecurityDesc

SECURITY_DESCRIPTOR

CSecurityDesc::FromString