LookupAccountName

【勇芳软件工作室】汉化HomePreviousNext

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不对应,则该函数将检查内置和管理定义的本地帐户。接下来,该函数检查主域。如果没有找到该名称,那么将检查受信任的域。

也可以看看

EqualPrefixSid, GetUserName, LookupAccountSid