次の方法で共有

IDot11AdHocManager::CreateNetwork メソッド (adhoc.h)

ワイヤレス アドホック ネットワークを作成します。 他のクライアントとホストは、このネットワークに接続できます。

構文

HRESULT CreateNetwork(
  [in]  LPCWSTR                     Name,
  [in]  LPCWSTR                     Password,
  [in]  LONG                        GeographicalId,
  [in]  IDot11AdHocInterface        *pInterface,
  [in]  IDot11AdHocSecuritySettings *pSecurity,
  [in]  GUID                        *pContextGuid,
  [out] IDot11AdHocNetwork          **pIAdHoc
);

パラメーター

[in] Name

ネットワークのフレンドリ名。 この文字列は 32 文字に制限する必要があります。 SSID はフレンドリ名として使用する必要があります。 この名前はビーコンでブロードキャストされます。

[in] Password

ネットワーク上のマシンまたはユーザー認証に使用されるパスワード。

パスワード文字列の長さは、 pSecurity パラメーターで渡されるセキュリティ設定によって異なります。 次の表は、さまざまなセキュリティ設定に関連付けられているパスワードの長さを示しています。

セキュリティ設定 パスワードの長さ
Open-None 0
Open-WEP 5 文字または 13 文字。10 桁または 26 桁の 16 進数
WPA2PSK 8 ~ 63 文字
 

上記のセキュリティ設定ペアに対応する列挙値については、「DOT11_ADHOC_AUTH_ALGORITHMとDOT11_ADHOC_CIPHER_ALGORITHM」を参照してください。

[in] GeographicalId

ネットワークが作成される地理的な場所。 使用可能な値の一覧については、「 地理的な場所のテーブル」を参照してください。

インターフェイスが 802.11d に準拠していない場合、この値は無視されます。 つまり、 IDot11AdHocInterface::IsDot11d が FALSE を返す場合、この値は無視されます。

使用する値がわからない場合は、 GeoId を CTRY_DEFAULT に設定します。 CTRY_DEFAULTを使用する場合、802.11d 準拠は適用されません。

[in] pInterface

新しいネットワークが作成されるネットワーク インターフェイスを指定する IDot11AdHocInterface への省略可能なポインター。 このパラメーターが NULL の場合は、最初に使用されていないインターフェイスが使用されます。 すべてのインターフェイスが使用されている場合は、最初の列挙インターフェイスが使用されます。 その場合、インターフェイス上の以前のネットワークは切断されます。

[in] pSecurity

ネットワークで使用されるセキュリティ設定を指定する IDot11AdHocSecuritySettings インターフェイスへのポインター。

[in] pContextGuid

ネットワークを作成したアプリケーションの GUID を指定する省略可能なパラメーター。 アプリケーションでは、この識別子を使用して 、GetIEnumDot11AdHocNetworks によって列挙されるネットワークを、アプリケーションによって作成されたネットワークに制限できます。 このフィルター処理を正しく機能させるには、すべてのマシン上のアプリケーションのすべてのインスタンスで同じ GUID を使用する必要があります。

[out] pIAdHoc

作成されたネットワークを表す IDot11AdHocNetwork インターフェイスへのポインター。

戻り値

可能な戻り値は次のとおりですが、これらに限定されません。

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
E_FAIL
 メソッドが失敗しました。
E_INVALIDARG
 いずれかのパラメーターが無効です。
E_NOINTERFACE
 指定されたインターフェイスはサポートされていません。
E_OUTOFMEMORY
 メソッドは、この操作を実行するために必要なメモリを割り当てませんでした。
E_POINTER
 パラメーターとして渡されたポインターが無効です。
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
 指定した名前のネットワークが既に存在します。
HRESULT_FROM_WIN32(ERROR_NOT_READY)
 pInterface インターフェイスは、その無線がオフになっていることを報告します。
HRESULT_FROM_WIN32(ERROR_NOT_CAPABLE)
 pInterface インターフェイスは、アドホック ネットワークを形成できないと報告します。 この状態は、NIC がアドホック ネットワークをサポートしていないか、または NIC が pSecurity によって提供されるセキュリティ設定をサポートしていないために発生する可能性があります。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 pSecurity の設定は、pInterface インターフェイスではサポートされていません。
HRESULT_FROM_WIN32(ERROR_ILL_FORMED_PASSWORD)
 指定された パスワード が無効です。 指定されたパスワードは、 pSecurity によって提供されるセキュリティ設定の長さが無効である可能性があります。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 コンピューターでワイヤレス ネットワーク インターフェイス カードが見つかりませんでした。
HRESULT_FROM_WIN32(ERROR_CURRENT_DOMAIN_NOT_ALLOWED)
 グループ ポリシーまたは管理設定では、ネットワークの作成が禁止されています。

注釈

CreateNetwork 呼び出しが成功すると、pIAdHoc によって返されるネットワーク オブジェクトはプロビジョニングされますが、構築されません。 CommitCreatedNetwork の後続の呼び出しによって、ネットワークが初期化されます。 ビーコンは、ネットワークがコミットされるまで送信されません。

CreateNetwork 呼び出しの後、ネットワークに接続されているクライアントまたはホストはありません。 アプリケーションには、 IDot11AdHocManagerNotificationSink インターフェイスを使用した接続試行の成功と失敗の両方が通知されます。 そのインターフェイスでの通知の登録の詳細については、「 IDot11AdHocManager」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー adhoc.h

こちらもご覧ください

CommitCreatedNetwork

IDot11AdHocManager

  • Last updated on