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.
NET_API_STATUS NET_API_FUNCTION NetGetDisplayInformationIndex( IN LPCWSTR ServerName, IN DWORD Level, IN LPCWSTR Prefix, OUT LPDWORD Index );
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.
Specifies the level of accounts to query. This parameter can be one of the following values.
||Query all local and global (normal) user accounts.|
||Query all workstation and server user accounts.|
||Query all global groups.|
Pointer to a string that specifies the prefix for which to search.
Pointer to a value that receives the index of the requested entry.
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.
||The user does not have access to the requested information.|
||The value specified for the Level parameter is invalid.|
||There were no more items on which to operate.|
||The computer name is invalid.|
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.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Header||lmaccess.h (include Lm.h)|