次の方法で共有


WFDOpenLegacySession 関数 (wlanapi.h)

WFDOpenLegacySession 関数は、Wi-Fi Direct レガシ デバイスの格納されたプロファイルを取得して適用します。

構文

DWORD WFDOpenLegacySession(
  HANDLE             hClientHandle,
  PDOT11_MAC_ADDRESS pLegacyMacAddress,
  HANDLE             *phSessionHandle,
  GUID               *pGuidSessionInterface
);

パラメーター

hClientHandle

このセッションの Wi-Fi Direct サービスへの HANDLE 。 このパラメーターは WFDOpenHandle 関数を使用して取得されます。

pLegacyMacAddress

レガシ クライアント デバイス Wi-Fi ダイレクト デバイス アドレスへのポインター。

phSessionHandle

このセッションの Wi-Fi Direct サービスへのハンドルを受け取る HANDLE へのポインター。

WFDOpenLegacySession 関数が成功した場合は、このセッションで使用する Wi-Fi Direct サービスへのハンドルが返されます。

pGuidSessionInterface

このセッションのネットワーク インターフェイスの GUID へのポインター。

WFDOpenLegacySession 関数が成功した場合、Direct セッション Wi-Fi 返されるネットワーク インターフェイスの GUID。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は次のいずれかの戻りコードになる可能性があります。

リターン コード 説明
ERROR_INVALID_PARAMETER
パラメーターが正しくありません。

phClientHandle または pLegacyMacAddress パラメーターが NULL の場合、このエラーが返されます。

ERROR_NOT_ENOUGH_MEMORY
このコマンドを処理するのに十分なストレージがありません。

このエラーは、システムがクライアント コンテキストを作成するためにメモリを割り当てられなかった場合に返されます。

RPC_STATUS
さまざまなエラー コード。

注釈

WFDOpenLegacySession 関数は、Windows 8とWindows Server 2012の新機能である Wi-Fi Direct の一部です。 Wi-Fi Direct は、Wi-Fi Alliance による Wi-Fi ピア ツー ピア技術仕様 v1.1 の開発に基づいています ( 「Wi-Fi Alliance 公開仕様」を参照)。 Wi-Fi ピア ツー ピア技術仕様の目的は、ワイヤレス アクセス ポイント (ワイヤレス AP) が接続をセットアップしたり、既存の Wi-Fi アドホック (IBSS) メカニズムを使用したりすることなく、デバイス間接続を Wi-Fi するためのソリューションを提供することです。

Wi-Fi Direct を使用するには、アプリケーションでまず WFDOpenLegacySession または WFDOpenHandle 関数を呼び出して、Wi-Fi Direct サービス へのハンドルを取得する 必要があります。 WFDOpenHandle 関数によって返される Wi-Fi Direct (WFD) ハンドルは、Wi-Fi Direct サービスに対する後続の呼び出しに使用されます。 WFDOpenLegacySession 関数は、Wi-Fi Direct レガシ デバイスの格納されたプロファイルを取得して適用するために使用されます。

WFDOpenLegacySession 関数は、指定されたレガシ デバイス アドレスのプロファイル ストアから、デバイスの保存されたレガシ プロファイルを取得します。 このデバイス アドレスは、受信トレイのペアリング エクスペリエンス (レガシ WPS ペアリング) の結果として作成されたデバイス ノードから取得する必要があります。

Wi-Fi Direct サービスを使用してアプリケーションが完了したら、アプリケーションは WFDCloseSession 関数を呼び出してセッションを閉じ、 WFDCloseHandle 関数を呼び出して、サービスを使用してアプリケーションが実行されたことを Wi-Fi Direct サービスに通知する必要があります。 これにより、Wi-Fi Direct サービスは、アプリケーションで使用されるリソースを解放できます。

要件

要件
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wlanapi.h
Library Wlanapi.lib
[DLL] Wlanapi.dll

こちらもご覧ください

WFDCancelOpenSession

WFDCloseHandle

WFDCloseSession

WFDOpenHandle

WFDStartOpenSession

WFDUpdateDeviceVisibility

WFD_OPEN_SESSION_COMPLETE_CALLBACK