INetSharingConfiguration::AddPortMapping メソッド (netcon.h)

  • [アーティクル]

[以降のバージョンでは、インターネット接続ファイアウォールが変更または使用できない場合があります。 代わりに、 Windows Firewall API を使用してください。

AddPortMapping メソッドは、この接続のサービス ポート マッピングを追加します。

構文

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

パラメーター

[in] bstrName

このポート マッピングの名前を含む BSTR 変数へのポインター。

[in] ucIPProtocol

ポート マッピングに設定する IP プロトコルを指定します。 IP プロトコルは、次のいずれかの値です。

NAT_PROTOCOL_TCP

NAT_PROTOCOL_UDP

[in] usExternalPort

このポート マッピングの外部ポートを指定します。

[in] usInternalPort

このポート マッピングの内部ポートを指定します。

[in] dwOptions

このパラメーターは予約されており、現時点では使用されません。

[in] bstrTargetNameOrIPAddress

このポート マッピングのターゲット コンピューターの名前を含む BSTR 変数へのポインター。 ターゲット名またはターゲット IP アドレスのいずれかを指定しますが、両方は指定しません。

[in] eTargetType

ターゲットの種類を示します。

[out] ppMapping

正常に戻った場合に、ポート マッピング用の INetSharingPortMapping インターフェイスを 指すポインターへのポインター。

戻り値

メソッドが成功した場合、戻り値はS_OK。

メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。

リターン コード 説明
E_ABORT
 操作が中止されました。
E_FAIL
 未指定のエラーが発生しました。
E_INVALIDARG
 パラメーターの 1 つが無効です。
E_NOINTERFACE
 指定されたインターフェイスはサポートされていません。
E_NOTIMPL
 指定したメソッドは実装されていません。
E_OUTOFMEMORY
 メソッドは、必要なメモリを割り当てることができませんでした。
E_POINTER
 パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED
 メソッドは不明な理由で失敗しました。

注釈

最初に追加すると、新しいマッピングは無効な状態になります。 新しいマッピングを有効にするには、 INetSharingPortMapping::Enable を使用します。

追加されると、ICS/ICF ユーザー インターフェイスの [ポート マッピング] リストに新しい定義が表示されます。

INetSharingManager::get_INetSharingConfigurationForINetConnection メソッドを使用して、特定の接続の INetSharingConfiguration インターフェイスを取得します。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー netcon.h
[DLL] Hnetcfg.dll

こちらもご覧ください

INetSharingConfiguration

インターネット接続の共有とインターネット接続ファイアウォール インターフェイス

インターネット接続の共有とインターネット接続ファイアウォールリファレンス