Funzione WNetEnumResourceW (winnetwk.h)
La funzione WNetEnumResource continua un'enumerazione delle risorse di rete avviate da una chiamata alla funzione WNetOpenEnum .
Sintassi
DWORD WNetEnumResourceW(
[in] HANDLE hEnum,
[in, out] LPDWORD lpcCount,
[out] LPVOID lpBuffer,
[in, out] LPDWORD lpBufferSize
);
Parametri
[in] hEnum
Handle che identifica un'istanza di enumerazione. Questo handle deve essere restituito dalla funzione WNetOpenEnum .
[in, out] lpcCount
Puntatore a una variabile che specifica il numero di voci richieste. Se il numero richiesto è -1, la funzione restituisce il maggior numero possibile di voci.
Se la funzione ha esito positivo, in caso di restituzione della variabile a cui punta questo parametro contiene il numero di voci effettivamente lette.
[out] lpBuffer
Puntatore al buffer che riceve i risultati dell'enumerazione. I risultati vengono restituiti come matrice di strutture NETRESOURCE . Si noti che il buffer allocato deve essere sufficientemente grande da contenere le strutture, oltre alle stringhe a cui puntano i relativi membri. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
Il buffer è valido fino alla chiamata successiva usando l'handle specificato dal parametro hEnum . L'ordine delle strutture NETRESOURCE nella matrice non è prevedibile.
[in, out] lpBufferSize
Puntatore a una variabile che specifica le dimensioni del parametro lpBuffer , in byte. Se il buffer è troppo piccolo per ricevere anche una voce, questo parametro riceve le dimensioni necessarie del buffer.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
L'enumerazione è riuscita e il buffer contiene i dati richiesti. L'applicazione chiamante può continuare a chiamare WNetEnumResource per completare l'enumerazione. |
|
Non ci sono più voci. Il contenuto del buffer non è definito. |
Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema, ad esempio uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Sono disponibili altre voci con le chiamate successive. Per ulteriori informazioni, vedere la sezione Osservazioni successiva. |
|
L'handle specificato dal parametro hEnum non è valido. |
|
La rete non è disponibile. Questa condizione viene testata prima che hEnum venga testato per la validità. |
|
Si è verificato un errore specifico della rete. Per ottenere una descrizione dell'errore, chiamare la funzione WNetGetLastError . |
Commenti
La funzione WNetEnumResource non enumera gli utenti connessi a una condivisione; è possibile chiamare la funzione NetConnectionEnum per eseguire questa attività. Per enumerare le condivisioni nascoste, chiamare la funzione NetShareEnum .
Un'applicazione non può impostare il parametro lpBuffer su NULL e recuperare le dimensioni del buffer necessarie dal parametro lpBufferSize . Al contrario, l'applicazione deve allocare un buffer di dimensioni ragionevoli, ovvero 16 kilobyte è tipico, e usare il valore di lpBufferSize per il rilevamento degli errori.
Esempio
Per un esempio di codice che illustra una funzione definita dall'applicazione che enumera tutte le risorse in una rete, vedere Enumerazione delle risorse di rete.
Nota
L'intestazione winnetwk.h definisce WNetEnumResource come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winnetwk.h |
| Libreria | Mpr.lib |
| DLL | Mpr.dll |