NetGetDisplayInformationIndex function

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

Syntax

NET_API_STATUS NET_API_FUNCTION NetGetDisplayInformationIndex(
  IN LPCWSTR  ServerName,
  IN DWORD    Level,
  IN LPCWSTR  Prefix,
  OUT LPDWORD Index
);

Parameters

ServerName

Pointer to a constant 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

Specifies the level of accounts to query. This parameter can be one of the following values.

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 string that specifies the prefix for which to search.

Index

Pointer to a value that receives the index of the requested entry.

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 code Description
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.

Remarks

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-Windows 2000 compatible access" group to view the information. If you call this function on a member server or workstation, all authenticated users can view the information. For information about anonymous access and restricting anonymous access on these platforms, see Security Requirements for the Network Management Functions. For more information on ACLs, ACEs, and access tokens, see Access Control Model.

The function only returns information to which the caller has Read access. The caller must have List Contents access to the Domain object, and Enumerate Entire SAM Domain access on the SAM Server object located in the System container.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header lmaccess.h (include Lm.h)
Library Netapi32.lib
DLL Netapi32.dll

See also

Get Functions

NetQueryDisplayInformation

Network Management Functions

Network Management Overview