Funzione WNetEnumResourceA (winnetwk.h)

Articolo
11/20/2024

La funzione WNetEnumResource continua un'enumerazione delle risorse di rete avviate 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 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 altre informazioni, vedere la sezione Osservazioni seguente.

Il buffer è valido fino alla chiamata successiva usando l'handle specificato dal parametro hEnum. L'ordine delle strutture di 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
NO_ERROR	L'enumerazione è riuscita 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	Sono disponibili altre voci con le chiamate successive. Per altre informazioni, vedere la sezione Osservazioni seguente.
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 .

Osservazioni

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.

Esempi

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winnetwk.h
libreria	Mpr.lib
dll	Mpr.dll