VB en Réseau

WNetEnumResource

Poursuit l'énumération des ressources réseau démarré par la fonction WNetOpenEnum

Declare Function WNetEnumResource Lib "mpr.dll" Alias "WNetEnumResourceA" _
               (ByVal hEnum As Long, _
                lpcCount As Long, _
                ByVal lpBuffer As Long, _
                lpBufferSize As Long) As Long

Paramètres :

hEnum : Handle de l'énumération qui a été retourné par la fonction WNetOpenEnum.

lpcCount : Contient le nombre d'occurrences demandé. Si ce nombre est 0xFFFFFFFF, alors la fonction retourne toutes les occurrences. Quand la fonction se finit normalement, la variable contient le nombre d'occurrence vraiment lu.

lpBuffer : Pointe vers le buffer qui reçoit le résultat de l'énumération, qui est un tableau de structures NETRESOURCE. Le buffer est valide jusqu'au prochain appel utilisant le handle hEnum.

lpBufferSize : Pointe vers une variable qui spécifie la taille, en octets, du buffer (lpBuffer). Si le buffer est trop petit pour recevoir le resultat, ce paramètre reçoit la taille requis par le buffer.

Code Retour

Si l'appel à la fonction réussie, le code retour prend une des valeurs suivantes :

Valeur	Signification
NO_ERROR	L'énumération est OK, et le buffer contient les informations demandées. L'application peut continuer en appelant la fonction WNetEnumResource pour finir l'énumération.
ERROR_NO_MORE_ITEMS	Il n'y a plus d'occurrences. Le contenu du buffer est indéfini.

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_MORE_DATA	Plus d'occurrences sont disponibles avec d'autres appels à la fonction.
ERROR_INVALID_HANDLE	Le handle donné par le paramètre hEnum n'est pas valide.
ERROR_NO_NETWORK	Pas de réseau présent. Cette condition est testée avant de contrôler la validité du handle hEnum.
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 :

La fonction WNetEnumResource ne donne pas les utilisateurs connectés sur une ressource partagée, il faut utiliser la fonction NetConnectionEnum. De même, pour obtenir les ressources cachées, il faut utiliser la fonction NetShareEnum. Une application ne peut pas alimenter le paramètre lpBuffer avec une valeur nulle et récupérer la bonne taille du buffer dans la variable lpBufferSize. Par contre, l'application peut allouer un buffer d'une taille raisonnable et utiliser la valeur de lpBufferSize pour détecter une erreur de taille de buffer.