Metodo INetSharingConfiguration::AddPortMapping (netcon.h)

Articolo
03/05/2024

[Firewall connessione Internet può essere modificato o non disponibile nelle versioni successive. Usare invece l'API Windows Firewall.

Il metodo AddPortMapping aggiunge un mapping delle porte del servizio per questa connessione.

Sintassi

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

Parametri

[in] bstrName

Puntatore a una variabile BSTR contenente il nome per il mapping della porta.

[in] ucIPProtocol

Specifica il protocollo IP da impostare per il mapping delle porte. Il protocollo IP è uno dei valori seguenti:

NAT_PROTOCOL_TCP

NAT_PROTOCOL_UDP

[in] usExternalPort

Specifica la porta esterna per il mapping delle porte.

[in] usInternalPort

Specifica la porta interna per il mapping delle porte.

[in] dwOptions

Questo parametro è riservato e non usato in questo momento.

[in] bstrTargetNameOrIPAddress

Puntatore a una variabile BSTR contenente il nome del computer di destinazione per il mapping delle porte. Specificare il nome di destinazione o l'indirizzo IP di destinazione, ma non entrambi.

[in] eTargetType

Indica il tipo di destinazione.

[out] ppMapping

Puntatore a un puntatore che, in caso di esito positivo, punta a un'interfaccia INetSharingPortMapping per il mapping delle porte.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è S_OK.

Se il metodo ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Codice restituito	Descrizione
E_ABORT	L'operazione è stata interrotta.
E_FAIL	Si è verificato un errore non specificato.
E_INVALIDARG	Uno dei parametri non è valido.
E_NOINTERFACE	Non è supportata un'interfaccia specificata.
E_NOTIMPL	Non viene implementato un metodo specificato.
E_OUTOFMEMORY	Il metodo non è riuscito a allocare la memoria necessaria.
E_POINTER	Un puntatore passato come parametro non è valido.
E_UNEXPECTED	Il metodo non è riuscito per motivi sconosciuti.

Commenti

Quando viene aggiunto per la prima volta, il nuovo mapping si trova in uno stato disabilitato. Per abilitare il nuovo mapping, usare INetSharingPortMapping::Enable.

Dopo aver aggiunto, la nuova definizione viene visualizzata nell'elenco Mapping porte nell'interfaccia utente ICS/ICF.

Usare il metodo INetSharingManager::get_INetSharingConfigurationForINetConnection per ottenere un'interfaccia INetSharingConfiguration per una connessione specifica.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	netcon.h
DLL	Hnetcfg.dll

Vedi anche

INetSharingConfiguration

Interfacce firewall connessione Internet e condivisione connessione Internet

Informazioni di riferimento sulla condivisione connessione Internet e sul firewall di connessione Internet

Condividi tramite