NetGetDisplayInformationIndex

The NetGetDisplayInformationIndex function gets the index of the first display information entry whose name begins with a specified string or alphabetically follows the string. You can use this function to determine a starting index for subsequent calls to the NetQueryDisplayInformation function.

Security Requirements

No special group membership is required to successfully execute NetGetDisplayInformationIndex.

NET_API_STATUS NetGetDisplayInformationIndex(
  LPWSTR ServerName,  // pointer to server to get information from
  DWORD Level,        // level of information to retrieve
  LPWSTR Prefix,      // pointer to prefix string
  LPDWORD Index       // receives index of entry
);

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
1 Query all Local and Global (normal) user accounts.
2 Query all Workstation and Server user accounts.
3 Query all Global Groups.

Prefix
Pointer to a null-terminated Unicode string containing the prefix for which to search.
Index
Pointer to a 32-bit variable that receives the index of the entry.

Return Values

If the function returns account information, the return value is NERR_Success.

If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_ACCESS_DENIED The user does not have access to the requested information.
ERROR_INVALID_LEVEL The value specified for the Level parameter is invalid.
ERROR_NO_MORE_ITEMS There were no more items on which to operate.
NERR_InvalidComputer The computer name is invalid.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in lmaccess.h.
  Import Library: Use netapi32.lib.

See Also

Networking (Net) Overview, Net Functions, NetQueryDisplayInformation