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

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 界面

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