Condividi tramite

Struttura NETRESOURCEA (winnetwk.h)

  • Articolo

La struttura seguente contiene informazioni su una risorsa di rete. Viene usato da diverse funzioni del provider di rete, tra cui NPOpenEnum e NPAddConnection.

Sintassi

typedef struct _NETRESOURCEA {
  DWORD dwScope;
  DWORD dwType;
  DWORD dwDisplayType;
  DWORD dwUsage;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  LPSTR lpComment;
  LPSTR lpProvider;
} NETRESOURCEA, *LPNETRESOURCEA;

Membri

dwScope

Indica l'ambito dell'enumerazione. Può trattarsi di uno dei valori seguenti.

Valore Significato
RESOURCE_CONNECTED
 Connessioni correnti alle risorse di rete.
RESOURCE_GLOBALNET
 Tutte le risorse di rete. Possono essere connessi o meno.
RESOURCE_CONTEXT
 Risorse di rete associate al contesto di rete corrente e predefinito dell'utente. Il significato di questa operazione è specifico del provider.

dwType

Indica il tipo di risorsa. Può trattarsi di uno dei valori seguenti.

Valore Significato
RESOURCETYPE_DISK
 La risorsa è un volume del disco condiviso.
RESOURCETYPE_PRINT
 La risorsa è una stampante condivisa.
RESOURCETYPE_ANY
 La risorsa corrisponde a più tipi, ad esempio un contenitore di risorse di stampa e disco o una risorsa che non è stampa o disco.

dwDisplayType

Impostare dal provider per indicare quale tipo di visualizzazione deve usare un'interfaccia utente per rappresentare questa risorsa. Sono definiti i tipi seguenti.

Valore Significato
RESOURCEDISPLAYTYPE_NETWORK
 La risorsa è un provider di rete.
RESOURCEDISPLAYTYPE_DOMAIN
 La risorsa è una raccolta di server.
RESOURCEDISPLAYTYPE_SERVER
 La risorsa è un server.
RESOURCEDISPLAYTYPE_SHARE
 La risorsa è un punto di condivisione.
RESOURCEDISPLAYTYPE_DIRECTORY
 La risorsa è una directory.
RESOURCEDISPLAYTYPE_GENERIC
 Il tipo di risorsa non è specificato. Questo valore viene usato dai provider di rete che non specificano i tipi di risorse.

dwUsage

Maschera di bit che indica come enumerare le informazioni sulla risorsa. Viene definito solo se dwScope è impostato su RESOURCE_GLOBALNET. Il campo dwUsage può contenere uno o più flag seguenti.

Valore Significato
RESOURCEUSAGE_CONNECTABLE
 È possibile connettersi alla risorsa chiamando NPAddConnection. Se dwType è RESOURCETYPE_DISK, dopo aver eseguito la connessione alla risorsa, è possibile usare le API del file system, ad esempio FindFirstFilee FindNextFile, per enumerare eventuali file e directory contenute nella risorsa.
RESOURCEUSAGE_CONTAINER
 La risorsa è un contenitore per altre risorse che possono essere enumerate tramite le funzioni NPOpenEnum, NPEnumResourcee npCloseEnum.

Il contenitore può tuttavia essere vuoto al momento della creazione dell'enumerazione. In altre parole, la prima chiamata a NPEnumResource può restituire WN_NO_MORE_ENTRIES.

lpLocalName

Se dwScope è RESOURCE_CONNECTED, il campo lpLocalName contiene il nome di un dispositivo reindirizzato. Se la connessione è una connessione senza dispositivo, questo campo contiene NULL.

Se dwScope non è impostato su RESOURCE_CONNECTED, questo campo non è definito.

lpRemoteName

Se l'elemento enumerato è una risorsa di rete, questo campo contiene un nome di rete remota. Questo nome può essere quindi passato a NPAddConnection per stabilire una connessione di rete se dwUsage è impostato su RESOURCEUSAGE_CONNECTABLE. Se l'elemento enumerato è una connessione corrente, questo campo farà riferimento al nome della rete remota a cui lpLocalName è connesso.

lpComment

Può essere qualsiasi commento fornito dal provider associato all'elemento enumerato.

lpProvider

Specifica il nome del provider proprietario dell'elemento enumerato.

Osservazioni

Nota

L'intestazione winnetwk.h definisce NETRESOURCE 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 XP [solo app desktop]
server minimo supportato Windows Server 2003 [solo app desktop]
intestazione winnetwk.h