CSecurityDesc::ToString
Converte um descritor de segurança em um formato de seqüência 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 terminada com nulo que receberá o formato de seqüência de caracteres de descritor de segurança.si
Especifica uma combinação de sinalizadores de bit SECURITY_INFORMATION para indicar os componentes do descritor de segurança para incluir na cadeia de saída.
Valor de retorno
Retorna verdadeiro sucesso, false em caso de falha.
Comentários
Depois que o descritor de segurança estiver no formato de seqüência de caracteres, pode mais com com facilidade ser armazenado ou transmitido.Use o CSecurityDesc::FromString método para converter a seqüência de caracteres de volta em um descritor de segurança.
The si parâmetro pode conter os seguintes sinalizadores SECURITY_INFORMATION:
Valor |
Significado |
|---|---|
OWNER_SECURITY_INFORMATION |
Inclua o proprietário. |
GROUP_SECURITY_INFORMATION |
Inclua o agrupar primário. |
DACL_SECURITY_INFORMATION |
Inclua a DACL. |
SACL_SECURITY_INFORMATION |
Inclua a SACL. |
Se a DACL é nulo e é o bit de controle SE_DACL_PRESENT conjunto no descritor de segurança de entrada, o método falhará.
Se a DACL é nulo e o bit de controle SE_DACL_PRESENT não está definido no descritor de segurança de entrada, a seqüência de caracteres de descritor de segurança resultante não tem um D: componente.See Formato de string de descritor de segurança para obter mais detalhes.
Este método só está disponível com o Windows 2000 e posterior, pois ele chama ConvertStringSecurityDescriptorToSecurityDescriptor.
Requisitos
Cabeçalho: atlsecurity.h