LookupAccountSidLocalA 函数（winbase.h）

项目
11/20/2024

LookupAccountSidLocalA 定义为调用 LookupAccountSidA 的宏，NULL 作为第一个参数。检索本地计算机上指定 SID 的帐户的名称。

语法

BOOL LookupAccountSidLocalA(
  [in]            PSID          Sid,
  [out, optional] LPSTR         Name,
  [in, out]       LPDWORD       cchName,
  [out, optional] LPSTR         ReferencedDomainName,
  [in, out]       LPDWORD       cchReferencedDomainName,
  [out]           PSID_NAME_USE peUse
);

参数

[in] Sid

指向要查找的 SID 的指针。

[out, optional] Name

指向接收 null-terminated 字符串的缓冲区的指针，该字符串包含与 lpSid 参数对应的帐户名称。

[in, out] cchName

在输入时，指定 lpName 缓冲区 TCHAR秒的大小。如果函数因缓冲区太小或 cchName 为零而失败，cchName 接收所需的缓冲区大小，包括终止 null 字符。

[out, optional] ReferencedDomainName

指向接收 null-terminated 字符串的缓冲区的指针，其中包含在其中找到帐户名称的域的名称。

在服务器上，为本地计算机安全数据库中的大多数帐户返回的域名是服务器为其域控制器的域的名称。

在工作站上，在本地计算机的安全数据库中为大多数帐户返回的域名是自系统最后一次启动时计算机的名称（排除反斜杠）。如果计算机名称发生更改，则旧名称将继续作为域名返回，直到系统重新启动。

某些帐户由系统预定义。为这些帐户返回的域名为 BUILTIN。

[in, out] cchReferencedDomainName

在输入时，指定 lpReferencedDomainName 缓冲区 TCHARs 的大小。如果函数由于缓冲区太小或 cchReferencedDomainName 为零而失败，cchReferencedDomainName 接收所需的缓冲区大小，包括终止 null 字符。

[out] peUse

指向接收指示帐户类型的 SID_NAME_USE 值的变量的指针。

返回值

如果函数成功，该函数将返回非零。

如果函数失败，则返回零。若要获取扩展的错误信息，请调用 GetLastError。

言论

此函数类似于 LookupAccountSid，但将搜索限制为本地计算机。

注意

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

要求

要求	价值
最低支持的客户端	Windows XP [仅限桌面应用]
支持的最低服务器	Windows Server 2003 [仅限桌面应用]
目标平台	窗户
标头	winbase.h （包括 Windows.h）