CSecurityDesc::ToString
文字列の書式にセキュリティ記述子を変換します。
bool ToString(
CString * pstr,
SECURITY_INFORMATION si = OWNER_SECURITY_INFORMATION |
GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION |
SACL_SECURITY_INFORMATION
) const throw(...);
パラメーター
pstr
文字列形式のセキュリティ記述子を受け取る null で終わる文字列へのポインター。si
SECURITY_INFORMATION のビット フラグの組み合わせをセキュリティ記述子のコンポーネントを出力文字列に含めるように指定します。
戻り値
正常に終了した場合は true を返します。それ以外の場合は false を返します。
解説
セキュリティ記述子が文字列の形式の場合、より簡単に格納したり、送信できます。セキュリティ記述子に再度文字列の変換に CSecurityDesc::FromString のメソッドを使用します。
si パラメーターには、次の SECURITY_INFORMATION のフラグが含まれることがあります:
値 |
説明 |
|---|---|
OWNER_SECURITY_INFORMATION |
所有者を指定します。 |
GROUP_SECURITY_INFORMATION |
プライマリ グループを含めます。 |
DACL_SECURITY_INFORMATION |
DACL を含めます。 |
SACL_SECURITY_INFORMATION |
SACL を含めます。 |
DACL が null 値であり、SE_DACL_PRESENT のコントロールのビットを入力するセキュリティ記述子に設定されている場合、メソッドは失敗します。
DACL が null 値であり、SE_DACL_PRESENT のコントロールのビットを入力するセキュリティ記述子に設定されていない場合、結果のセキュリティ記述子文字列にはありません: D コンポーネント。セキュリティ記述子文字列の書式 を詳細については、" "を参照してください。
このメソッドは ConvertStringSecurityDescriptorToSecurityDescriptorを呼び出すため、Windows 2000 でのみ使用可能であり、後で。
必要条件
ヘッダー : atlsecurity.h