Funzione NetGetDisplayInformationIndex (lmaccess.h)
La funzione NetGetDisplayInformationIndex restituisce l'indice della prima voce di informazioni visualizzate il cui nome inizia con una stringa specificata o il cui nome segue alfabeticamente la stringa. È possibile usare questa funzione per determinare un indice iniziale per le chiamate successive alla funzione NetQueryDisplayInformation .
Sintassi
NET_API_STATUS NET_API_FUNCTION NetGetDisplayInformationIndex(
[in] LPCWSTR ServerName,
[in] DWORD Level,
[in] LPCWSTR Prefix,
[out] LPDWORD Index
);
Parametri
[in] ServerName
Puntatore a una stringa costante che specifica il nome DNS o NetBIOS del server remoto in cui deve essere eseguita la funzione. Se questo parametro è NULL, viene utilizzato il computer locale.
[in] Level
Specifica il livello di account da eseguire per la query. Questo parametro può avere uno dei valori seguenti.
[in] Prefix
Puntatore a una stringa che specifica il prefisso per il quale eseguire la ricerca.
[out] Index
Puntatore a un valore che riceve l'indice della voce richiesta.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NERR_Success.
Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
|
L'utente non ha accesso alle informazioni richieste. |
|
Il valore specificato per il parametro Level non è valido. |
|
Non c'erano più elementi su cui operare. |
|
Il nome del computer non è valido. |
Commenti
Se si chiama questa funzione in un controller di dominio che esegue Active Directory, l'accesso viene consentito o negato in base all'elenco di controllo di accesso (ACL) per l'oggetto a protezione diretta. L'elenco di controllo di accesso predefinito consente a tutti gli utenti autenticati e i membri del gruppo "Accesso compatibile con Pre-Windows 2000" di visualizzare le informazioni. Se si chiama questa funzione in un server membro o in una workstation, tutti gli utenti autenticati possono visualizzare le informazioni. Per informazioni sull'accesso anonimo e sulla limitazione dell'accesso anonimo in queste piattaforme, vedere Requisiti di sicurezza per le funzioni di gestione di rete. Per altre informazioni su ACL, ACL e token di accesso, vedere Controllo di accesso Model.
La funzione restituisce solo informazioni a cui il chiamante ha accesso in lettura. Il chiamante deve avere accesso a List Contents all'oggetto Domain e Enumerate Entire SAM Domain access on the SAM Server object located in the System container.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | lmaccess.h (include Lm.h) |
| Libreria | Netapi32.lib |
| DLL | Netapi32.dll |