Fonction NPGetConnection3 (npapi.h)

Article
02/29/2024

Récupère des informations sur une connexion réseau, même si elle est actuellement déconnectée.

Syntaxe

DWORD NPGetConnection3(
  [in]      LPCWSTR lpLocalName,
  [in]      DWORD   dwLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Paramètres

[in] lpLocalName

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

[in] dwLevel

Valeur qui spécifie si la connexion réseau est actuellement connectée ou déconnectée.

Valeur	Signification
WNGETCON_CONNECTED	La connexion réseau est connectée.
WNGETCON_DISCONNECTED	La connexion réseau est déconnectée.

[out] lpBuffer

Pointeur Void qui reçoit une mémoire tampon contenant les informations demandées.

[in, out] lpBufferSize

Pointeur vers la taille, en caractères, de la mémoire tampon lpBuffer . 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.

Si la fonction échoue, elle doit retourner l’une des valeurs suivantes.

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

Une connexion réseau peut exister dans trois états : connecté, déconnecté et indisponible. La fonction NPGetConnection3 ne peut pas récupérer d’informations sur les connexions réseau actuellement indisponibles. Toutefois, il peut récupérer des informations sur les connexions réseau actuellement déconnectées, car Windows stocke les informations de connexion.

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

Partager via