LookupAccountName函数接受系统和帐户的名称作为输入。它检索帐户的安全标识符(SID)和找到该帐户的域的名称。
BOOL LookupAccountName(
LPCTSTR 【lpSystemName】, | //系统名字符串的地址 |
LPCTSTR 【lpAccountName】, | //帐号的字符串地址 |
PSID 【希德】, | //安全标识符的地址 |
LPDWORD 【cbSid】, | //安全标识符大小的地址 |
LPTSTR 【ReferencedDomainName】, | //引用域的字符串地址 |
LPDWORD 【cbReferencedDomainName】, | //域字符串大小的地址 |
PSID_NAME_USE 【peUse】 | // SID型指示器的地址 |
); |
参数
【lpSystemName】
指向指定系统的以null结尾的字符串。该字符串可以是远程计算机的名称。如果此字符串为NULL,则会在本地系统上查找帐户名称。
【lpAccountName】
指向指定帐户名称的以null结尾的字符串。
【希德】
指向接收SID结构对应于【lpAccountName】参数指向的帐户名称的缓冲区。
【cbSid】
指向DWORD变量。在输入时,此值指定【希德】缓冲区的大小(以字节为单位)。如果由于缓冲区太小而导致功能失败,则此变量会接收所需的缓冲区大小。
【ReferencedDomainName】
指向缓冲区,接收找到帐户名的域名。
【cbReferencedDomainName】
指向DWORD变量。在输入时,此值指定【ReferencedDomainName】缓冲区的大小(以字节为单位(ANSI版本)或字符(Unicode版本))。如果该函数因缓冲区太小而失败,则该变量将接收所需的缓冲区大小,包括终止空字符。
【peUse】
指向SID_NAME_USE枚举类型,指示函数返回时的帐户类型。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
LookupAccountName功能尝试通过首先检查众所周知的SID列表来查找指定名称的安全标识符。如果该名称与众所周知的SID不对应,则该函数将检查内置和管理定义的本地帐户。接下来,该函数检查主域。如果没有找到该名称,那么将检查受信任的域。
也可以看看