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;

Members

dwScope

Indica l'ambito dell'enumerazione. Questo può essere uno dei valori seguenti.

Valore Significato
RESOURCE_CONNECTED
 Connessioni correnti alle risorse di rete.
RESOURCE_GLOBALNET
 Tutte le risorse di rete Questi possono o non essere connessi.
RESOURCE_CONTEXT
 Le risorse di rete associate al contesto di rete corrente e predefinito dell'utente. Il significato di questo è specifico del provider.

dwType

Indica il tipo di risorsa. Questo può essere 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. I tipi seguenti sono definiti.

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 FindFirstFile e FindNextFile, per enumerare tutti i file e le directory contenute nella risorsa.
RESOURCEUSAGE_CONTAINER
 La risorsa è un contenitore per altre risorse che possono essere enumerate tramite le funzioni NPOpenEnum, NPEnumResource e 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 remoto. Questo nome può essere quindi passato a NPAddConnection per creare una connessione di rete se dwUsage è impostato su RESOURCEUSAGE_CONNECTABLE. Se l'elemento enumerato è una connessione corrente, questo campo fa riferimento al nome di rete remoto a cui lpLocalName è connesso.

lpComment

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

lpProvider

Specifica il nome del provider proprietario di questo elemento enumerato.

Commenti

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 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 XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione winnetwk.h