Partager via

STRUCTURE NETRESOURCEW (winnetwk.h)

  • Article

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 _NETRESOURCEW {
  DWORD  dwScope;
  DWORD  dwType;
  DWORD  dwDisplayType;
  DWORD  dwUsage;
  LPWSTR lpLocalName;
  LPWSTR lpRemoteName;
  LPWSTR lpComment;
  LPWSTR lpProvider;
} NETRESOURCEW, *LPNETRESOURCEW;

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 ou ne pas être connectés.
RESOURCE_CONTEXT
 Ressources réseau associées au contexte réseau actuel et par défaut de l’utilisateur. La signification de ceci est spécifique 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 imprimée ni disque.

dwDisplayType

Défini par le fournisseur pour indiquer quel type d’affichage 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 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 de 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 n’est définie que 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 que vous êtes connecté à la ressource, vous pouvez utiliser les API du système de fichiers, telles que FindFirstFileet 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, NPEnumResourceet NPCloseEnum.

Toutefois, le conteneur peut être vide au moment où l’énumération est effectuée. 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 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

Peut être un commentaire fourni par un fournisseur associé à l’élément énuméré.

lpProvider

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

Remarques

Note

L’en-tête winnetwk.h définit NETRESOURCE comme 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows XP [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
d’en-tête winnetwk.h