Funzione WNetEnumResourceA (winnetwk.h)

Articolo
08/27/2023

La funzione WNetEnumResource continua un'enumerazione delle risorse di rete avviata da una chiamata alla funzione WNetOpenEnum .

Sintassi

DWORD WNetEnumResourceA(
  [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 puntata da 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 sufficiente per contenere le strutture, oltre alle stringhe a cui puntano i 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 da 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
NO_ERROR	L'enumerazione ha avuto esito positivo e il buffer contiene i dati richiesti. L'applicazione chiamante può continuare a chiamare WNetEnumResource per completare l'enumerazione.
ERROR_NO_MORE_ITEMS	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
ERROR_MORE_DATA	Altre voci sono disponibili con chiamate successive. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
ERROR_INVALID_HANDLE	L'handle specificato dal parametro hEnum non è valido.
ERROR_NO_NETWORK	La rete non è disponibile. Questa condizione viene testata prima che hEnum venga testata per la validità.
ERROR_EXTENDED_ERROR	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 . L'applicazione deve invece 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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