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

[アーティクル]
08/25/2023

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

EnableSharing メソッドは、この接続で共有を有効にします。

構文

HRESULT EnableSharing(
  [in] SHARINGCONNECTIONTYPE Type
);

パラメーター

[in] Type

この接続をパブリックとプライベートのどちらで共有するかを指定します。

戻り値

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

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

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

注釈

このメソッドを呼び出すと、次の通知がトリガーされます。

%programname% は、ネットワーク接続 %connectionname% でインターネット接続共有を有効にしようとしています。これにより、ネットワーク上の他のコンピューターが共有パブリック接続を介してインターネットに接続できるようになります。 %programname% でこの接続でインターネット接続の共有を有効にしますか?

呼び出し元のアプリケーションで、この接続がパブリックに共有されていることを指定した場合、以前のパブリック共有接続はすべて自動的に無効になります。

パブリック共有接続では、インターネット接続ファイアウォールが自動的に有効になります。プライベート共有接続では、既存の設定が保持されます。

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

要件

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