Export (0) Print
Expand All
Expand Minimize

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 NetGetDisplayInformationIndex(
  _In_   LPCWSTR ServerName,
  _In_   DWORD Level,
  _In_   LPCWSTR Prefix,
  _Out_  LPDWORD Index
);

Parameters

ServerName [in]

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 [in]

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

ValueMeaning
1

Query all local and global (normal) user accounts.

2

Query all workstation and server user accounts.

3

Query all global groups.

 

Prefix [in]

Pointer to a string that specifies the prefix for which to search.

Index [out]

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 codeDescription
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]

Header

Lmaccess.h (include Lm.h)

Library

Netapi32.lib

DLL

Netapi32.dll

See also

Network Management Overview
Network Management Functions
Get Functions
NetQueryDisplayInformation

 

 

Community Additions

ADD
Show:
© 2014 Microsoft