Funzione NPEnumResource (npapi.h)

  • Articolo

Esegue un'enumerazione basata su un handle restituito da NPOpenEnum.

Sintassi

DWORD NPEnumResource(
  [in]      HANDLE  hEnum,
  [in, out] LPDWORD lpcCount,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Parametri

[in] hEnum

Handle ottenuto da una chiamata NPOpenEnum .

[in, out] lpcCount

Puntatore al numero di voci richieste. Potrebbe essere 0xFFFFFFFF richiedere il maggior numero possibile di voci. Se la chiamata ha esito positivo, questo percorso riceverà il numero di voci effettivamente lette.

[out] lpBuffer

Puntatore al buffer per ricevere il risultato dell'enumerazione, che viene restituito come matrice di voci NETRESOURCE . Il buffer è valido fino alla chiamata successiva usando hEnum.

[in, out] lpBufferSize

Puntatore alla dimensione, in byte, del buffer passato alla chiamata di funzione alla voce. Se il buffer è troppo piccolo per una sola voce, deve contenere, all'uscita, il numero di byte necessari per leggere una voce. Questo valore viene impostato solo se il codice restituito è WN_MORE_DATA.

Valore restituito

Se la funzione ha esito positivo, deve restituire WN_SUCCESS. Il chiamante può continuare a chiamare NPEnumResource per continuare l'enumerazione. In caso contrario, deve restituire uno dei codici di errore seguenti.

Codice restituito Descrizione
WN_NO_MORE_ENTRIES
 Nessuna voce. L'enumerazione è stata completata correttamente. In questo caso, il contenuto del buffer restituito, lpBuffer, non è definito.
WN_MORE_DATA
 Il buffer è troppo piccolo per contenere anche una singola voce.
WN_BAD_HANDLE
 hEnum non è un handle valido.
WN_NO_NETWORK
 La rete non è presente. Questa condizione viene verificata prima che hEnum venga testato per la validità.

Commenti

Quando questa funzione viene chiamata, il provider deve riempire il buffer con il numero richiesto di voci (o il valore massimo che può essere adatto). Le strutture NETRESOURCE restituite devono trovarsi in modo contiguo all'inizio del buffer, ad esempio una matrice di tali strutture. I puntatori in queste strutture devono puntare a posizioni all'interno del buffer. Pertanto, i dati a cui fanno riferimento questi puntatori devono trovarsi alla fine del buffer, dopo la matrice di strutture. È responsabilità del provider creare correttamente il pacchetto di queste informazioni.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione npapi.h