ConvertStringSecurityDescriptorToSecurityDescriptor

ConvertStringSecurityDescriptorToSecurityDescriptor 函数

ConvertStringSecurityDescriptorToSecurityDescriptor 函数将一个字符串格式 安全描述符 转换为一个有效的、 功能的安全描述符。 此函数检索 ConvertSecurityDescriptorToStringSecurityDescriptor 功能转换为字符串格式的安全描述符。

语法

C++

BOOL WINAPI ConvertStringSecurityDescriptorToSecurityDescriptor (__in LPCTSTR  StringSecurityDescriptor ，DWORD  StringSDRevision ，__out PSECURITY_DESCRIPTOR __in *  SecurityDescriptor ，__out PULONG  SecurityDescriptorSize ) ；

参数

StringSecurityDescriptor [中]

指向一个空结尾的字符串包含要转换的 字符串格式安全描述符 的指针。

StringSDRevision [中]

指定 StringSecurityDescriptor 字符串的修订级别。 当前，此值必须 SDDL_REVISION_1。

SecurityDescriptor [out]

指向一个变量，接收转换后的安全描述符的指针的指针。 返回的安全描述符是 自相关联 。 要释放返回的缓冲区，调用 LocalFree 函数。 若要将安全描述符转换为一个 绝对安全描述符 中，使用 MakeAbsoluteSD 功能。

SecurityDescriptorSize [out]

指向一个变量，接收该的大小以字节为单位的转换后的安全描述符的指针。 此参数可以是 NULL。

返回值

如果该函数成功，返回值是，则返回非零值。

如果函数失败，返回值是零。 若要获取扩展的错误的信息，请调用 GetLastError 。 GetLastError 可能会返回以下错误代码之一。

返回代码	描述
ERROR_INVALID_PARAMETER	参数不是有效的。
ERROR_UNKNOWN_REVISION	SDDL 修订级别无效。
ERROR_NONE_MAPPED	一个 安全标识符 (SID 输入的安全描述符字符串中) 找不到一个帐户查找操作。