| 术语 | netwkstauserenum |
| 释义 | NetWkstaUserEnum 语法： C++ NET_API_STATUS NetWkstaUserEnum( __in LPWSTR servername, __in DWORD level, __out LPBYTE *bufptr, __in DWORD prefmaxlen, __out LPDWORD entriesread, __out LPDWORD totalentries, __inout LPDWORD resumehandle ); NetWkstaUserEnum功能 该NetWkstaUserEnum功能罗列了所有当前登录到工作站的用户的信息。此列表包括互动，服务和批处理登录。 参数 服务器名 [in] 指针指向一个字符串，它指定的DNS或NetBIOS的远程服务器上的功能是执行的名称。如果该参数为NULL，则使用本地计算机。 Level [in] 指定的数据信息的Level。此参数可以是下列值之一。 ValueMeaning 0Return的用户名当前登录到该工作站。在bufptr参数指向一个WKSTA_USER_INFO_0结构的数组。 1Return名称，当前用户和工作站访问的域名。在bufptr参数指向一个WKSTA_USER_INFO_1结构的数组。 bufptr [out] 指针的缓冲区，接收数据。这一数据格式取决于Level的参数值。此缓冲区分配制度，必须使用NetApiBufferFree释放功能。请注意，您必须释放缓冲区，即使函数ERROR_MORE_DATA失败。 prefmaxlen [in] 指定返回数据的首选的最大字节长度。如果您指定MAX_PREFERRED_LENGTH，功能分配用于数据所需的内存量。如果指定这个参数在另一个值，它可以限制的字节数函数返回。如果缓冲区大小不足以容纳所有作品，该函数返回ERROR_MORE_DATA。有关更多信息，请参阅网络管理功能，缓冲器和网络管理功能缓冲区长度。 entriesread [out] 指针的值，它接收元素计数实际列举。 totalentries [out] 指针的值，它接收了本来可以列举参赛总人数从目前的恢复情况。请注意，应用程序应考虑仅作为提示此值。 resumehandle [ in , out ] 指针的值，它包含简历处理，用于继续现有的搜索。手柄应在第一次调用零，离开后续调用不变。如果该参数是NULL，没有恢复处理存储。 返回值 如果函数成功，返回值是NERR_Success。 如果函数失败，返回值可以是下面的错误代码之一。 返回codeDescription ERROR_ACCESS_DENIEDThe用户没有获得所需的信息。 ERROR_MORE_DATAMore项可用。指定一个足够大的缓冲区接收的所有条目。 ERROR_INVALID_LEVELTheLevel参数无效。 备注 请注意，由于NetWkstaUserEnum列出了服务功能和批处理登录，以及交互式登录项，函数可以返回谁已注销工作站用户条目。可能发生这种情况，例如，当用户调用一个服务，模拟用户。在这种情况下，NetWkstaUserEnum返回一个用户进入，直到服务停止模拟用户。 Server 2003和Windows XP中：如果您调用域控制器上运行Active Directory的这一功能，允许访问或拒绝关于在安全对象的ACL的视窗。要启用匿名访问，用户必须是匿名的“前成员Windows 2000兼容访问”组。这是因为匿名令牌不包括Everyone组默认的SID。如果您调用一个成员服务器或工作站，所有的身份验证的用户可以查看此功能的信息。匿名访问也是允许的，如果RestrictAnonymous的策略设置允许匿名访问。 If the RestrictAnonymous policy setting does not permit anonymous access, only an administrator can successfully execute the function.系统管理员议员，服务器，系统和打印操作地方团体也可以查看的信息。如需有关限制匿名访问的信息，请参阅的网络管理功能的安全要求。欲了解更多有关的ACL，ACE的，和访问令牌信息，请访问控制模型。 Windows 2000中：如果您调用域控制器上运行Active Directory的这一功能，允许访问或拒绝的访问控制列表的安全对象(ACL)的基础。默认的ACL允许所有经过身份验证的用户和“前成员Windows2000兼容访问”组查看信息。默认情况下，“预Windows2000兼容访问”组包括每个人作为成员。这使得匿名访问的信息如果系统允许匿名访问。如果您调用一个成员服务器或工作站，所有的身份验证的用户可以查看此功能的信息。匿名访问也是允许的，如果RestrictAnonymous的策略设置允许匿名访问。 要编译的应用程序使用此函数，定义为0x0400或更高_WIN32_WINNT宏。有关详细信息，请参阅使用Windows头。 实例 下面的代码示例演示了如何列出的所有当前登录到一个工作站使用调用NetWkstaUserEnum功能，用户的信息。该范例调用NetWkstaUserEnum，指定信息化Level0(WKSTA_USER_INFO_0)。通过参赛作品并打印到一个工作站登录的用户的名称示例循环。最后，代码示例释放的信息缓冲区分配的内存，并打印用户总数枚举。 #ifndef UNICODE #define UNICODE #endif #pragma comment(lib, "netapi32.lib") #include #include #include #include int wmain(int argc, wchar_t *argv[]) { LPWKSTA_USER_INFO_0 pBuf = NULL; LPWKSTA_USER_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; LPWSTR pszServerName = NULL; if (argc > 2) { fwprintf(stderr, L"Usage: %s [\\\\\\\\ServerName]\\n", argv[0]); exit(1); } // The server is not the default local computer. // if (argc == 2) pszServerName = argv[1]; fwprintf(stderr, L"\\nUsers currently logged on %s:\\n", pszServerName); // // Call the NetWkstaUserEnum function, specifying level 0. // do // begin do { nStatus = NetWkstaUserEnum( pszServerName, dwLevel, (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) { // // Only members of the Administrators local group // can successfully execute NetWkstaUserEnum // locally and on a remote server. // fprintf(stderr, "An access violation has occurred\\n"); break; } // // Print the user logged on to the workstation. // wprintf(L"\\t-- %s\\n", pTmpBuf->wkui0_username); pTmpBuf++; dwTotalCount++; } } } // // Otherwise, indicate a system error. // else fprintf(stderr, "A system error has occurred: %d\\n", nStatus); // // Free the allocated memory. // if (pBuf != NULL) { NetApiBufferFree(pBuf); pBuf = NULL; } } // // Continue to call NetWkstaUserEnum 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 workstation users. // fprintf(stderr, "\\nTotal of %d entries enumerated\\n", dwTotalCount); return 0; } 要求： 最低支持：client－Windows 2000专业版 最低支持server－Windows 2000服务器 HeaderLmwksta.h(包括Lm.h) LibraryNetapi32.lib DLLNetapi32.dll 参见 网络管理概述 网络管理功能 工作站和工作站用户功能 NetWkstaGetInfo NetWkstaSetInfo WKSTA_USER_INFO_0 WKSTA_USER_INFO_1 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年8月13日 ＝＝英文原文＝＝NetWkstaUserEnum Function The NetWkstaUserEnum function lists information about all users currently logged on to the workstation. This list includes interactive, service and batch logons. Syntax C++ NET_API_STATUS NetWkstaUserEnum( __in LPWSTR servername, __in DWORD level, __out LPBYTE *bufptr, __in DWORD prefmaxlen, __out LPDWORD entriesread, __out LPDWORD totalentries, __inout LPDWORD resumehandle ); Parameters servername [in] Pointer to a string that specifies the DNS or NetBIOS name of the remote server on which the function is to execute. If this parameter is NULL, the local computer is used. level [in] Specifies the information level of the data. This parameter can be one of the following values. ValueMeaning 0Return the names of users currently logged on to the workstation. The bufptr parameter points to an array of WKSTA_USER_INFO_0 structures. 1Return the names of the current users and the domains accessed by the workstation. The bufptr parameter points to an array of WKSTA_USER_INFO_1 structures. bufptr [out] Pointer to the buffer that receives the data. The format of this data depends on the value of the level parameter. This buffer is allocated by the system and must be freed using the NetApiBufferFree function. Note that you must free the buffer even if the function fails with ERROR_MORE_DATA. prefmaxlen [in] Specifies the preferred maximum length of returned data, in bytes. If you specify MAX_PREFERRED_LENGTH, the function allocates the amount of memory required for the data. If you specify another value in this parameter, it can restrict the number of bytes that the function returns. If the buffer size is insufficient to hold all entries, the function returns ERROR_MORE_DATA. For more information, see Network Management Function Buffers and Network Management Function Buffer Lengths . entriesread [out] Pointer to a value that receives the count of elements actually enumerated. totalentries [out] Pointer to a value that receives the total number of entries that could have been enumerated from the current resume position. Note that applications should consider this value only as a hint. resumehandle [in, out] Pointer to a value that contains a resume handle which is used to continue an existing search. The handle should be zero on the first call and left unchanged for subsequent calls. If this parameter is NULL, no resume handle is stored. Return Value If the function succeeds, the return value is NERR_Success. If the function fails, the return value can be one of the following error codes. Return codeDescription ERROR_ACCESS_DENIEDThe user does not have access to the requested information. ERROR_MORE_DATAMore entries are available. Specify a large enough buffer to receive all entries. ERROR_INVALID_LEVELThe level parameter is invalid. Remarks Note that since the NetWkstaUserEnum function lists entries for service and batch logons, as well as for interactive logons, the function can return entries for users who have logged off a workstation. This can occur, for example, when a user calls a service that impersonates the user. In this instance, NetWkstaUserEnum returns an entry for the user until the service stops impersonating the user. Windows Server 2003 and Windows XP: If you call this function on a domain controller that is running Active Directory, access is allowed or denied based on the ACL for the securable object. To enable anonymous access, the user Anonymous must be a member of the "Pre-Windows 2000 compatible access" group. This is because anonymous tokens do not include the Everyone group SID by default. If you call this function on a member server or workstation, all authenticated users can view the information. Anonymous access is also permitted if the RestrictAnonymous policy setting permits anonymous access. If the RestrictAnonymous policy setting does not permit anonymous access, only an administrator can successfully execute the function. Members of the Administrators, and the Server, System and Print Operator local groups can also view information. For more information about restricting anonymous access, see Security Requirements for the Network Management Functions . For more information on ACLs, ACEs, and access tokens, see Access Control Model . Windows 2000: If you call this function on a domain controller that is running Active Directory, access is allowed or denied based on the access control list (ACL) for the securable object. The default ACL permits all authenticated users and members of the " Pre-Windows2000 compatible access " group to view the information. By default, the "Pre-Windows2000 compatible access" group includes Everyone as a member. This enables anonymous access to the information if the system allows anonymous access. If you call this function on a member server or workstation, all authenticated users can view the information. Anonymous access is also permitted if the RestrictAnonymous policy setting allows anonymous access. To compile an application that uses this function, define the _WIN32_WINNT macro as 0x0400 or later. For more information,see Using the Windows Headers . Examples The following code sample demonstrates how to list information about all users currently logged on to a workstation using a call to the NetWkstaUserEnum function. The sample calls NetWkstaUserEnum, specifying information level 0 ( WKSTA_USER_INFO_0 ). The sample loops through the entries and prints the names of the users logged on to a workstation. Finally, the code sample frees the memory allocated for the information buffer, and prints the total number of users enumerated. #ifndef UNICODE #define UNICODE #endif #pragma comment(lib, "netapi32.lib") #include #include #include #include int wmain(int argc, wchar_t *argv[]) { LPWKSTA_USER_INFO_0 pBuf = NULL; LPWKSTA_USER_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; LPWSTR pszServerName = NULL; if (argc > 2) { fwprintf(stderr, L"Usage: %s [\\\\\\\\ServerName]\\n", argv[0]); exit(1); } // The server is not the default local computer. // if (argc == 2) pszServerName = argv[1]; fwprintf(stderr, L"\\nUsers currently logged on %s:\\n", pszServerName); // // Call the NetWkstaUserEnum function, specifying level 0. // do // begin do { nStatus = NetWkstaUserEnum( pszServerName, dwLevel, (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) { // // Only members of the Administrators local group // can successfully execute NetWkstaUserEnum // locally and on a remote server. // fprintf(stderr, "An access violation has occurred\\n"); break; } // // Print the user logged on to the workstation. // wprintf(L"\\t-- %s\\n", pTmpBuf->wkui0_username); pTmpBuf++; dwTotalCount++; } } } // // Otherwise, indicate a system error. // else fprintf(stderr, "A system error has occurred: %d\\n", nStatus); // // Free the allocated memory. // if (pBuf != NULL) { NetApiBufferFree(pBuf); pBuf = NULL; } } // // Continue to call NetWkstaUserEnum 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 workstation users. // fprintf(stderr, "\\nTotal of %d entries enumerated\\n", dwTotalCount); return 0; } Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderLmwksta.h (include Lm.h) LibraryNetapi32.lib DLLNetapi32.dll See Also Network Management Overview Network Management Functions Workstation and Workstation User Functions NetWkstaGetInfo NetWkstaSetInfo WKSTA_USER_INFO_0 WKSTA_USER_INFO_1 Send comments about this topic to Microsoft Build date: 8/13/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/aa370669(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。