NetGetDisplayInformationIndex function (lmaccess.h)
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
[in] 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.
[in] Level
Specifies the level of accounts to query. This parameter can be one of the following values.
| Value | Meaning |
|---|---|
|
Query all local and global (normal) user accounts. |
|
Query all workstation and server user accounts. |
|
Query all global groups. |
[in] Prefix
Pointer to a string that specifies the prefix for which to search.
[out] 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 |
|---|---|
|
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. |
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
| Requirement | Value |
|---|---|
| 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 |