|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| No
| Win32s
| No
| Import Library
| netapi32.lib
| Header File
| lmaccess.h
| Unicode
| WinNT
| Platform Notes
| All LanMan APIs are UNICODE only
|
|
|
NetQueryDisplayInformation
The NetQueryDisplayInformation function returns user, computer, or global group account information. Use
this function to quickly enumerate account information for display in user
interfaces.
Security Requirements
No special group membership is required to successfully execute NetQueryDisplayInformation.
NET_API_STATUS NetQueryDisplayInformation(
LPWSTR ServerName,
|
| DWORD Level,
|
| DWORD Index,
|
| DWORD EntriesRequested,
|
| DWORD PreferredMaximumLength,
|
| LPDWORD ReturnedEntryCount,
|
| PVOID *SortedBuffer
|
| );
|
|
Parameters
ServerName
Pointer to a null-terminated Unicode string containing the name of the remote
server on which the function is to execute. A NULL pointer or string specifies
the local computer.
Level
Specifies one of the following values to return the level of information
provided.
Value
| Meaning
| -
| Return all Local and Global (normal) user accounts. The returned buffer points
to an array of NET_DISPLAY_USER structures.
| -
| Return all Workstation and Server (BDC) user accounts. The returned buffer
points to an array of NET_DISPLAY_MACHINE structures.
| -
| Return all Global Groups. The returned buffer points to an array of NET_DISPLAY_GROUP structures.
|
Index
Specifies the index of the first entry for which to retrieve information.
Specify zero to retrieve account information beginning with the first display
information entry. If a call to NetQueryDisplayInformation returns ERROR_MORE_DATA, you can set Index to the value returned in the next_index member of the last entry in SortedBuffer to get data for additional entries. To retrieve information for entries
beginning with a specified prefix, set Index to the index returned by a call to the NetGetDisplayInformationIndex function.
EntriesRequested
Specifies the maximum number of entries for which to get information.
PreferredMaximumLength
Specifies the preferred maximum size, in 8-bit bytes, of the system-allocated
buffer returned in the SortedBuffer parameter.
ReturnedEntryCount
Pointer to a 32-bit variable that receives the number of entries in the buffer
returned in the SortedBuffer parameter. Zero indicates that there are no entries with an index as large as
that specified. Entries may be returned when the function's return value is
either NERR_Success or ERROR_MORE_DATA.
SortedBuffer
Points to a variable that receives a pointer to a system-allocated buffer
containing a sorted list of the requested information. This buffer contains an
array of NET_DISPLAY_USER, NET_DISPLAY_MACHINE or NET_DISPLAY_GROUP structures. Use NetApiBufferFree to deallocate the buffer.
Return Values
If the function returns account information, the return value is one of the
following values.
Value
| Meaning
| NERR_Success
| There are no more entries to be returned.
| ERROR_MORE_DATA
| More entries are available. That is, the last entry returned in the SortedBuffer parameter is not the last entry available. To get information for additional
entries, call NetQueryDisplayInformation again with the Index parameter set to the value returned in the next_index member of the last entry in SortedBuffer.
|
If the function fails, the return value is one of the following error code.
Value
| Meaning
| ERROR_ACCESS_DENIED
| The user does not have access to the requested information.
| ERROR_INVALID_LEVEL
| The Level parameter specifies an invalid value.
|
Remarks
The NetQueryDisplayInformation and NetGetDisplayInformationIndex functions provide a very efficient mechanism for enumerating User and Global
group accounts. When possible, use these functions instead of the NetUserEnum and NetGroupEnum functions.
See Also
NET_DISPLAY_USER, NetApiBufferFree, NetGetDisplayInformationIndex, NetGroupEnum, NetUserEnum
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
