CopySid 函数 (securitybaseapi.h)
CopySid 函数将安全标识符 (SID) 复制到缓冲区。
语法
BOOL CopySid(
[in] DWORD nDestinationSidLength,
[out] PSID pDestinationSid,
[in] PSID pSourceSid
);
参数
[in] nDestinationSidLength
指定接收 SID 副本的缓冲区的长度(以字节为单位)。
[out] pDestinationSid
指向接收源 SID 结构副本的缓冲区的指针。
[in] pSourceSid
指向 SID 结构的指针,该函数复制到 pDestinationSid 参数指向的缓冲区。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
应用程序可以使用 CopySid 函数在 访问令牌 (创建 SID 的副本,例如,在 TOKEN_GROUPS 结构中,) 在访问控制项中使用的 (ACE) 。
示例
有关使用此函数的示例,请参阅 获取登录 SID。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | securitybaseapi.h (包括 Windows.h) |
Library | Advapi32.lib |
DLL | Advapi32.dll |