Partager via


Fonction NPGetConnection (npapi.h)

Récupère des informations sur une connexion.

Syntaxe

DWORD NPGetConnection(
  [in]      LPWSTR  lpLocalName,
  [out]     LPWSTR  lpRemoteName,
  [in, out] LPDWORD lpnBufferLen
);

Paramètres

[in] lpLocalName

Pointeur vers le nom de l’appareil local qui intéresse l’appelant. Le fournisseur de réseau peut supposer que ce nom est valide sur le point de vue syntaxique.

[out] lpRemoteName

Pointeur vers une mémoire tampon qui recevra le nom distant utilisé pour établir la connexion. Cette mémoire tampon est allouée par l’appelant.

[in, out] lpnBufferLen

Pointeur vers la taille, en caractères, de la mémoire tampon lpRemoteName . Si l’appel échoue parce que la mémoire tampon n’est pas assez grande, lpBufferSize est défini sur la taille de mémoire tampon requise.

Valeur retournée

Si la fonction réussit, elle doit retourner WN_SUCCESS. Sinon, il doit retourner un code d’erreur, qui peut être l’un des suivants :

Code de retour Description
WN_NOT_CONNECTED
L’appareil spécifié par lpLocalName n’est pas redirigé par ce fournisseur.
WN_MORE_DATA
La mémoire tampon était trop petite pour recevoir toutes les données.
WN_NO_NETWORK
Le réseau n’est pas présent.

Remarques

La fonction NPGetConnection peut retourner des informations uniquement sur une connexion réseau actuellement connectée. Pour récupérer des informations sur une connexion réseau actuellement déconnectée, utilisez NPGetConnection3.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête npapi.h