Compartir a través de

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

  • Artículo

[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