WNetGetConnection

 Retour fonctions Api

Retour fonctions de réseau

Description

Paramètre

lpszLocalName

lpszRemoteName

lpnLength

Valeur renvoyée

Retrouve le nom d' une ressource réseau

Type/Description

String - Chaîne spécifiant soit le nom du device local pour obtenir le nom du réseau

String - Tampon recevant le nom distant (null terminated) utilisée pour faire la connection

Long - Variable spécifiant la taille, en caractères, du tampon lpRemoteName. Si l'appel échoue car la tampon n'est pas assez grand, cette variable contiendra la taille requise pour le tampon

Long - Si la fonction réussi, la valeur de retour sera NO_ERROR, sinon la valeur sera un code d'erreur. Voir GetLastError
GetLastError peut retourner un des codes d'erreurs suivants :

ERROR_BAD_DEVICE : la chaîne pointée vers le paramètre lpLocalName est invalide

ERROR_NOT_CONNECTED : le device spécifiée par lpLocalName n'est pas redirigé

ERROR_MORE_DATA : le tampon est trop petit. Le paramètre lpnLength pointe vers une variable qui contient la taille requise pour le tampon

ERROR_CONNECTION_UNAVAIL : le device n'est pas couramment connecté, mais la connection est persistante

ERROR_NO_NETWORK : pas de réseau disponible

ERROR_EXTENDED_ERROR : une erreur spécifique réseau a eu lieu. Pour obtenir une description de l'erreur, utiliser la fonction WNetGetLastError

ERROR_NO_NET_OR_BAD_PATH : aucun des providers n'ont reconnus le nom local comme ayant une connection.