【API】NetUserEnum-获取系统所有账户名称

稀土 2018-02-03

1 说明

该NetUserEnum函数检索服务器上所有用户帐户的信息。

函数原型:

NET_API_STATUS NetUserEnum(
  _In_    LPCWSTR servername,
  _In_    DWORD   level,
  _In_    DWORD   filter,
  _Out_   LPBYTE  *bufptr,
  _In_    DWORD   prefmaxlen,
  _Out_   LPDWORD entriesread,
  _Out_   LPDWORD totalentries,
  _Inout_ LPDWORD resume_handle
);

参数说明

servername [in]

指向常量字符串的指针,该字符串指定要在其上执行函数的远程服务器的DNS或NetBIOS名称。如果此参数为NULL,则使用本地计算机。

level[in]

指定数据的信息级别。

filter [in]

指定要包含在枚举中的用户帐户类型的值。值为零表示应该包括所有正常用户,信任数据和机器账户数据。

bufptr [out]

接收数据的指针。

prefmaxlen [in]

返回数据的首选最大长度(以字节为单位)。如果指定MAX_PREFERRED_LENGTH,则NetUserEnum函数会分配数据所需的内存量。如果在此参数中指定另一个值,则可以限制该函数返回的字节数。如果缓冲区大小不足以保存所有条目,则函数返回ERROR_MORE_DATA。

entriesread [out]

指向一个值的指针,它接收实际枚举的元素的数量。

totalentries [out]

指向一个值的指针,该值接收可能已从当前继续位置枚举的条目总数。

resume_handle [in, out]

指向包含用于继续现有用户搜索的恢复句柄的值的指针。

返回值

如果函数成功,返回值是NERR_Success。

2 代码

void CMy20180203_MFC_获取系统所有账户名称Dlg::OnBnClickedGetalluser()
{
    // TODO: 在此添加控件通知处理程序代码
    UpdateData(TRUE);

    LPUSER_INFO_0 pBuf = NULL;
    LPUSER_INFO_0 pTmpBuf;
    DWORD dwLevel = 0;
    DWORD dwPrefMaxLen = MAX_PREFERRED_LENGTH;
    DWORD dwEntriesRead = 0;
    DWORD dwTotalEntries = 0;
    DWORD dwResumeHandle = 0;
    DWORD i;
    DWORD dwTotalCount = 0;
    NET_API_STATUS nStatus;
    LPTSTR pszServerName = NULL;

    do // begin do
    {
        nStatus = NetUserEnum(NULL,
            dwLevel,
            FILTER_NORMAL_ACCOUNT, // global users
            (LPBYTE*)&pBuf,
            dwPrefMaxLen,
            &dwEntriesRead,
            &dwTotalEntries,
            &dwResumeHandle);
        //
        // If the call succeeds,
        //
        if ((nStatus == NERR_Success) || (nStatus == ERROR_MORE_DATA))
        {
            if ((pTmpBuf = pBuf) != NULL)
            {
                //
                // Loop through the entries.
                //
                for (i = 0; (i < dwEntriesRead); i++)
                {
                    assert(pTmpBuf != NULL);

                    if (pTmpBuf == NULL)
                    {
                        m_username.Format(_T("%s"), "An access violation has occurred\n");
                        break;
                    }
                    //
                    //  Print the name of the user account.
                    //

                    TCHAR tcBuffer[1024] = { 0 };
                    wsprintf(tcBuffer, L"\t-- %s\r\n", pTmpBuf->usri0_name);
                    m_username += tcBuffer;

                    pTmpBuf++;
                    dwTotalCount++;
                }
            }
        }
        //
        // Otherwise, print the system error.
        //
        else
            fprintf(stderr, "A system error has occurred: %d\n", nStatus);
        //
        // Free the allocated buffer.
        //
        if (pBuf != NULL)
        {
            NetApiBufferFree(pBuf);
            pBuf = NULL;
        }
    }
    // Continue to call NetUserEnum while 
    //  there are more entries. 
    // 
    while (nStatus == ERROR_MORE_DATA); // end do
                                        //
                                        // Check again for allocated memory.
                                        //
    if (pBuf != NULL)
        NetApiBufferFree(pBuf);
    //
    // Print the final count of users enumerated.
    //
    m_CountNum.Format(L"总计有%d个账户被枚举", dwTotalCount);
    
    UpdateData(FALSE);
}

3 界面

【API】NetUserEnum-获取系统所有账户名称

4 参考

  • MFC中EDIT控件实现换行

http://blog.csdn.net/dearwind153/article/details/50241537

  • NetUserEnum function

https://msdn.microsoft.com/en-us/library/windows/desktop/aa370652(v=vs.85).aspx

相关推荐