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

[El firewall de conexión a Internet puede modificarse o no estar disponible en versiones posteriores. En su lugar, use la API de Firewall de Windows.

El método AddPortMapping agrega una asignación de puerto de servicio para esta conexión.

Sintaxis

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
);

Parámetros

[in] bstrName

Puntero a una variable BSTR que contiene el nombre de esta asignación de puertos.

[in] ucIPProtocol

Especifica el protocolo IP que se va a establecer para la asignación de puertos. El protocolo IP es uno de los siguientes valores:

NAT_PROTOCOL_TCP

NAT_PROTOCOL_UDP

[in] usExternalPort

Especifica el puerto externo para esta asignación de puertos.

[in] usInternalPort

Especifica el puerto interno para esta asignación de puertos.

[in] dwOptions

Este parámetro está reservado y no se usa en este momento.

[in] bstrTargetNameOrIPAddress

Puntero a una variable BSTR que contiene el nombre del equipo de destino para esta asignación de puertos. Especifique el nombre de destino o la dirección IP de destino, pero no ambos.

[in] eTargetType

Indica el tipo de destino.

[out] ppMapping

Puntero a un puntero que, al devolverse correctamente, apunta a una interfaz INetSharingPortMapping para la asignación de puertos.

Valor devuelto

Si el método se ejecuta correctamente, el valor devuelto es S_OK.

Si se produce un error en el método, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto	Descripción
E_ABORT	Se anuló la operación.
E_FAIL	Se ha producido un error no especificado.
E_INVALIDARG	Uno de los parámetros no es válido.
E_NOINTERFACE	No se admite una interfaz especificada.
E_NOTIMPL	No se implementa un método especificado.
E_OUTOFMEMORY	El método no pudo asignar la memoria necesaria.
E_POINTER	Un puntero pasado como parámetro no es válido.
E_UNEXPECTED	Error en el método por motivos desconocidos.

Comentarios

Cuando se agrega por primera vez, la nueva asignación está en un estado deshabilitado. Para habilitar la nueva asignación, use INetSharingPortMapping::Enable.

Una vez agregada, la nueva definición aparece en la lista Asignaciones de puertos de la interfaz de usuario ICS/ICF.

Use el método INetSharingManager::get_INetSharingConfigurationForINetConnection para obtener una interfaz INetSharingConfiguration para una conexión determinada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	netcon.h
Archivo DLL	Hnetcfg.dll

Consulte también

INetSharingConfiguration

Interfaces de firewall de conexión compartida y conexión a Internet

Referencia de firewall de conexión compartida y conexión a Internet