Funzione NPOpenEnum (npapi.h)

Apre un'enumerazione delle risorse di rete o delle connessioni esistenti. La funzione NPOpenEnum deve essere chiamata per ottenere un handle valido per un'enumerazione.

Sintassi

DWORD NPOpenEnum(
  [in]  DWORD          dwScope,
  [in]  DWORD          dwType,
  [in]  DWORD          dwUsage,
  [in]  LPNETRESOURCEW lpNetResource,
  [out] LPHANDLE       lphEnum
);

Parametri

[in] dwScope

Determina l'ambito dell'enumerazione. Può trattarsi di una delle opzioni seguenti.

[in] dwType

Specifica il tipo di risorse di interesse. Si tratta di una maschera di bit, che può essere qualsiasi combinazione dei flag seguenti.

Se dwType è 0 o è solo RESOURCEUSAGE_ATTACHED, vengono restituiti tutti i tipi di risorse. Se un provider non ha la possibilità di distinguere tra le risorse di stampa e disco allo stesso livello, può restituire tutte le risorse.

[in] dwUsage

Specifica l'utilizzo delle risorse di interesse. Si tratta di una maschera di bit, che può essere qualsiasi combinazione dei flag seguenti.

La maschera di bit può essere zero in modo che corrisponda a tutti i flag. Questo parametro può essere ignorato se dwScope non è impostato su RESOURCE_GLOBALNET.

[in] lpNetResource

Puntatore al contenitore per eseguire l'enumerazione . NetRESOURCE potrebbe essere stato ottenuto tramite una precedente chiamata NPEnumResource o costruita dal chiamante oppure può essere NULL. Se è NULL o se il campo lpRemoteName di NETRESOURCE è NULL, il provider deve enumerare il livello superiore della rete. Si noti che questo significa che un provider non può usare un lpRemoteNamenull per rappresentare qualsiasi risorsa di rete. Un chiamante inizia normalmente chiamando NPOpenEnum con questo parametro impostato su NULL e quindi usare i risultati restituiti per un'ulteriore enumerazione. Se il programma chiamante conosce esattamente il provider e il percorso remoto da cui enumerare, può creare la propria struttura NETRESOURCE da passare, compilando i campi lpProvider e lpRemoteName . Si noti che se dwScope è RESOURCE_CONNECTED o RESOURCE_CONTEXT, questo parametro sarà NULL.

[out] lphEnum

Puntatore a un handle che può essere usato dalla funzione NPEnumResource . Al termine dell'uso dell'handle, rilasciare l'handle chiamando la funzione NPCloseEnum .

Valore restituito

Se la funzione ha esito positivo, deve restituire WN_SUCCESS. In caso contrario, deve restituire un codice di errore che può includere una delle opzioni seguenti.

Requisiti