函数原型

参数(StringSecurityDescriptor[in] StringSDRevision[in] SecurityDescriptor[out] SecurityDescriptorSize[out])

返回值

备注

需求

ConvertStringSecurityDescriptorToSecurityDescriptor 函数可以将一个按安全描述符格式的字符串转换成一个有效的安全描述符结构。本函数和ConvertSecurityDescriptorToStringSecurityDescriptor函数的功能相反。

函数原型

BOOL WINAPI ConvertStringSecurityDescriptorToSecurityDescriptor(

__in LPCTSTR StringSecurityDescriptor,

__in DWORD StringSDRevision,

__out PSECURITY_DESCRIPTOR *SecurityDescriptor,

__out PULONG SecurityDescriptorSize

);

参数

StringSecurityDescriptor[in]

一个字符串，以'\\0'为结束符，是一个符合安全描述符的字符串，是本函数用来转换的源字符串。

StringSDRevision[in]

指定StringSecurityDescriptor的修订级别，目前的版本必须是SDDL_REVISION_1。

SecurityDescriptor[out]

一个指向用来存储转换后的SID变量。返回的安全描述符是自相关的。要释放返回的缓冲区，需要调用LocalFree函数。为了将安全描述符转换成一个绝对安全描述符，需要调用MakeAbsoluteSD函数。

SecurityDescriptorSize[out]

一个指向存储返回的缓冲区大小的变量。如果不需要，可以将这个参数传入NULL。

返回值

如果函数成功，则返回非0值，否则返回0。可以调用GetLastError获得更详细的错误原因。GetLastError可能返回的错误代码如下：

返回值　描述

ERROR_INVALID_PARAMETER　某个参数是无效的。

ERROR_UNKNOWN_REVISION　参数StringSDRevision是不正确。

ERROR_NONE_MAPPED　输入字符串描述的SID在账户查询操作中找不到

备注

If ace_type is ACCESS_ALLOWED_OBJECT_ACE_TYPE and neither object_guid nor inherit_object_guid has a GUID specified, then ConvertStringSecurityDescriptorToSecurityDescriptor converts ace_type to ACCESS_ALLOWED_ACE_TYPE. For information about the ace_type, object_guid, and inherit_object_guid fields, see Ace Strings.

需求

系统最低要求　Windows 2000 Professional

服务器最低要求　Windows 2000 Server

头文件　Sddl.h

静态库　Advapi32.lib

动态库　Advapi32.dll

Unicode和ANSI的函数名　ConvertStringSecurityDescriptorToSecurityDescriptorW (Unicode)
ConvertStringSecurityDescriptorToSecurityDescriptorA (ANSI)