Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 |
|---|---|
|
L’appareil spécifié par lpLocalName n’est pas redirigé par ce fournisseur. |
|
La mémoire tampon était trop petite pour recevoir toutes les données. |
|
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 |