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