Méthode INetSharingConfiguration ::AddPortMapping (netcon.h)

Article
02/29/2024

[Le pare-feu de connexion Internet peut être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt l’API pare-feu Windows.]

La méthode AddPortMapping ajoute un mappage de port de service pour cette connexion.

Syntaxe

HRESULT AddPortMapping(
  [in]  BSTR                   bstrName,
  [in]  UCHAR                  ucIPProtocol,
  [in]  USHORT                 usExternalPort,
  [in]  USHORT                 usInternalPort,
  [in]  DWORD                  dwOptions,
  [in]  BSTR                   bstrTargetNameOrIPAddress,
  [in]  ICS_TARGETTYPE         eTargetType,
  [out] INetSharingPortMapping **ppMapping
);

Paramètres

[in] bstrName

Pointeur vers une variable BSTR qui contient le nom de ce mappage de port.

[in] ucIPProtocol

Spécifie le protocole IP à définir pour le mappage de port. Le protocole IP est l’une des valeurs suivantes :

NAT_PROTOCOL_TCP

NAT_PROTOCOL_UDP

[in] usExternalPort

Spécifie le port externe pour ce mappage de port.

[in] usInternalPort

Spécifie le port interne pour ce mappage de port.

[in] dwOptions

Ce paramètre est réservé et n’est pas utilisé pour l’instant.

[in] bstrTargetNameOrIPAddress

Pointeur vers une variable BSTR qui contient le nom de l’ordinateur cible pour ce mappage de port. Spécifiez le nom de la cible ou l’adresse IP cible, mais pas les deux.

[in] eTargetType

Indique le type cible.

[out] ppMapping

Pointeur vers un pointeur qui, en cas de retour réussi, pointe vers une interface INetSharingPortMapping pour le mappage de port.

Valeur retournée

Si la méthode réussit, la valeur de retour est S_OK.

Si la méthode échoue, la valeur de retour est l’un des codes d’erreur suivants.

Code de retour	Description
E_ABORT	L'opération a été abandonnée.
E_FAIL	Une erreur non spécifiée s'est produite.
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_NOINTERFACE	Une interface spécifiée n’est pas prise en charge.
E_NOTIMPL	Une méthode spécifiée n’est pas implémentée.
E_OUTOFMEMORY	La méthode n’a pas pu allouer la mémoire requise.
E_POINTER	Un pointeur passé en tant que paramètre n’est pas valide.
E_UNEXPECTED	La méthode a échoué pour des raisons inconnues.

Remarques

Lorsqu’il est ajouté pour la première fois, le nouveau mappage est dans un état désactivé. Pour activer le nouveau mappage, utilisez INetSharingPortMapping ::Enable.

Une fois ajoutée, la nouvelle définition apparaît dans la liste Mappages de ports de l’interface utilisateur ICS/ICF.

Utilisez la méthode INetSharingManager ::get_INetSharingConfigurationForINetConnection pour obtenir une interface INetSharingConfiguration pour une connexion particulière.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	netcon.h
DLL	Hnetcfg.dll

Voir aussi

INetSharingConfiguration

Partage de connexion Internet et interfaces de pare-feu de connexion Internet

Informations de référence sur le partage de connexion Internet et le pare-feu de connexion Internet

Partager via