VB en Réseau

WNetOpenEnum

Démarre une énumération des ressources réseaux ou des connections existantes.

Public Declare Function WNetOpenEnum Lib "mpr.dll" Alias _
"WNetOpenEnumA" ( _
ByVal dwScope As Long, _
ByVal dwType As Long, _
ByVal dwUsage As Long, _
lpNetResource As Any, _
lphEnum As Long) As Long

Paramètres

dwScope : Spécifie le champ d'énumération. Ce paramètre peut prendre une des valeurs suivantes :

Valeur	Signification
RESOURCE_CONNECTED	Toutes les ressources connectées. Le paramètre dwUsage est ignoré
RESOURCE_CONTEXT	Seulement les ressources du voisinage réseau de l'appelant (utilisé pour une vue du voisinage réseau). Le paramètre dwUsage est ignoré.
RESOURCE_GLOBALNET	Toutes les ressources du réseau.
RESOURCE_REMEMBERED	Toutes les connections persistantes. Le paramètre dwUsage est ignoré.

dwType : Spécifie le type de ressources à énumérer. Ce paramètre peut être une combinaison des valeurs suivantes :

Valeur	Signification
RESOURCETYPE_ANY	Toutes les ressources (Cette valeur ne peut pas être combiné avec RESOURCETYPE_DISK ou RESOURCETYPE_PRINT)
RESOURCETYPE_DISK	Toutes les ressources disques
RESOURCETYPE_PRINT	Toutes les ressources imprimantes

dwUsage : Spécifie l'usage de la ressource qui est énumérée. Ce paramètre peut être une combinaison des valeurs suivantes :

Valeur	Signification
0	Toutes les ressources
RESOURCEUSAGE_CONNECTABLE	Toutes les ressources connectables
RESOURCEUSAGE_CONTAINER	Toutes les ressources d'une partie du réseau

Ce paramètre est ignoré si le paramètre dwScope n'est pas RESOURCE_GLOBALNET.

lpNetResource : Pointe vers une structure NETRESOURCE spécifiant la partie du réseau à énumérer. Si le paramètre est de valeur nulle, la racine du réseau est utilisée. Windows organise un réseau comme une hiérarchie.
Si le paramètre n'est pas de valeur nulle, il doit pointer vers une structure NETRESOURCE. Cette structure doit être remplie par l'application ou être retourné par un appel de la fonction WNetEnumResource. La structure NETRESOURCE doit spécifier une partie de réseau ; la valeur RESOURCEUSAGE_CONTAINER doit être spécifiée au niveau de dwUsage.
Pour énumérer toutes les ressources réseaux, une application peut commencer par appeler WNetOpenEnum avec lpNetResource à NULL et utiliser le handle en retour avec WNetEnumResource pour faire l'énumération des ressources. Si une des ressources dans le tableau de NETRESOURCE retourné par la fonction WNetEnumResource est une partie du réseau, WNetOpenEnum peut être utilisé pour ouvrir la ressource pour une nouvelle énumération.
Si le paramètre dwScope n'est pas RESOURCE_GLOBALNET, ce paramètre doit être à NULL.

lphEnum : Pointe vers une variable remplie avec un handle d'énumération qui peut être utilisé dans un autre appel à WNetEnumResource.

Code Retour

Si l'appel à la fonction réussie, le code retour est NO_ERROR.
Si l'appel à la fonction échoue, le code retour est égal à un code erreur. Pour avoir plus d'informations sur l'erreur, il faut appeler la fonction GetLastError.
GetLastError peut retourner un des codes erreurs suivants :

Valeur	Signification
ERROR_NOT_CONTAINER	Le paramètre lpNetResource ne pointe pas sur une partie du réseau
ERROR_INVALID_PARAMETER	Soit dwScope ou dwType est invalide, soit il y a une mauvaise combinaison des paramètres.
ERROR_NO_NETWORK	Pas de réseau présent.
ERROR_EXTENDED_ERROR	Une erreur spécifique aux réseaux a eu lieu. Pour avoir une description de l'erreur, utiliser la fonction WNetGetLastError.

Remarques

L'interprétation exacte de RESOURCE_CONTEXT pour le paramètre dwScope dépend de l'installation réseau sur la machine.