Partager via


NPGetConnection, fonction (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 de manière syntactique.

[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, car 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 éléments suivants :

Code de retour Descriptif
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 ne peut retourner des informations que 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.

Spécifications

Requirement Valeur
Client minimum requis Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Fenêtres
Header npapi.h
Library davclnt.lib