Structure NETRESOURCEA (winnetwk.h)

Article
08/27/2023

La structure suivante contient des informations sur une ressource réseau. Il est utilisé par plusieurs fonctions du fournisseur de réseau, notamment NPOpenEnum et NPAddConnection.

Syntaxe

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

Membres

dwScope

Indique l’étendue de l’énumération. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
RESOURCE_CONNECTED	Connexions actuelles aux ressources réseau.
RESOURCE_GLOBALNET	Toutes les ressources réseau. Ceux-ci peuvent être connectés ou non.
RESOURCE_CONTEXT	Ressources réseau associées au contexte réseau actuel et par défaut de l’utilisateur. La signification de ceci est propre au fournisseur.

dwType

Indique le type de ressource. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
RESOURCETYPE_DISK	La ressource est un volume de disque partagé.
RESOURCETYPE_PRINT	La ressource est une imprimante partagée.
RESOURCETYPE_ANY	La ressource correspond à plusieurs types, par exemple, un conteneur de ressources d’impression et de disque, ou une ressource qui n’est ni impression ni disque.

dwDisplayType

Défini par le fournisseur pour indiquer le type d’affichage qu’une interface utilisateur doit utiliser pour représenter cette ressource. Les types suivants sont définis.

Valeur	Signification
RESOURCEDISPLAYTYPE_NETWORK	La ressource est un fournisseur de réseau.
RESOURCEDISPLAYTYPE_DOMAIN	La ressource est une collection de serveurs.
RESOURCEDISPLAYTYPE_SERVER	La ressource est un serveur.
RESOURCEDISPLAYTYPE_SHARE	La ressource est un point de partage.
RESOURCEDISPLAYTYPE_DIRECTORY	La ressource est un répertoire.
RESOURCEDISPLAYTYPE_GENERIC	Le type de ressource n’est pas spécifié. Cette valeur est utilisée par les fournisseurs réseau qui ne spécifient pas de types de ressources.

dwUsage

Masque de bits qui indique comment énumérer des informations sur la ressource. Elle est définie uniquement si dwScope est défini sur RESOURCE_GLOBALNET. Le champ dwUsage peut contenir un ou plusieurs des indicateurs suivants.

Valeur	Signification
RESOURCEUSAGE_CONNECTABLE	Vous pouvez vous connecter à la ressource en appelant NPAddConnection. Si dwType est RESOURCETYPE_DISK, une fois connecté à la ressource, vous pouvez utiliser les API de système de fichiers, telles que FindFirstFile et FindNextFile, pour énumérer les fichiers et répertoires que contient la ressource.
RESOURCEUSAGE_CONTAINER	La ressource est un conteneur pour d’autres ressources qui peuvent être énumérées au moyen des fonctions NPOpenEnum, NPEnumResource et NPCloseEnum . Toutefois, le conteneur peut être vide au moment de l’énumération. En d’autres termes, le premier appel à NPEnumResource peut retourner WN_NO_MORE_ENTRIES.

lpLocalName

Si dwScope est RESOURCE_CONNECTED, le champ lpLocalName contient le nom d’un appareil redirigé. Si la connexion est une connexion sans appareil, ce champ contient NULL.

Si dwScope n’est pas défini sur RESOURCE_CONNECTED, ce champ n’est pas défini.

lpRemoteName

Si l’élément énuméré est une ressource réseau, ce champ contient un nom de réseau distant. Ce nom peut ensuite être passé à NPAddConnection pour établir une connexion réseau si dwUsage est défini sur RESOURCEUSAGE_CONNECTABLE. Si l’élément énuméré est une connexion actuelle, ce champ fait référence au nom de réseau distant auquel lpLocalName est connecté.

lpComment

Il peut s’agir de tout commentaire fourni par le fournisseur associé à l’élément énuméré.

lpProvider

Spécifie le nom du fournisseur propriétaire de cet élément énuméré.

Remarques

Notes

L’en-tête winnetwk.h définit NETRESOURCE comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	winnetwk.h

Partager via