convertStringSidToSidA 函数 (sddl.h)

项目
03/05/2024

ConvertStringSidToSid 函数将字符串格式的安全标识符 (SID) 转换为有效的功能 SID。可以使用此函数检索 ConvertSidToStringSid 函数转换为字符串格式的 SID。

语法

BOOL ConvertStringSidToSidA(
  [in]  LPCSTR StringSid,
  [out] PSID   *Sid
);

参数

[in] StringSid

指向以 null 结尾的字符串的指针，该字符串包含要转换的字符串格式 SID。

SID 字符串可以使用标准 S-R-I-S-S... SID 字符串的格式，或 SID 字符串常量格式，例如内置管理员的“BA”。有关 SID 字符串表示法的详细信息，请参阅 SID 组件。

[out] Sid

指向变量的指针，该变量接收指向转换后的 SID 的指针。若要释放返回的缓冲区，请调用 LocalFree 函数。

返回值

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

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。 GetLastError 函数可能会返回以下错误代码之一。

返回代码	说明
ERROR_INVALID_PARAMETER	参数无效。
ERROR_INVALID_SID	SID 无效。

注解

注意

sddl.h 标头将 ConvertStringSidToSid 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	sddl.h
Library	Advapi32.lib
DLL	Advapi32.dll