次の方法で共有


WFDStartOpenSession 関数 (wlanapi.h)

WFDStartOpenSession 関数は、Windows ペアリング エクスペリエンスを通じて以前にペアリングされた特定の Wi-Fi Direct デバイスへのオンデマンド接続を開始します。

構文

DWORD WFDStartOpenSession(
  [in]           HANDLE                             hClientHandle,
  [in]           PDOT11_MAC_ADDRESS                 pDeviceAddress,
  [in, optional] PVOID                              pvContext,
  [in]           WFD_OPEN_SESSION_COMPLETE_CALLBACK pfnCallback,
  [out]          PHANDLE                            phSessionHandle
);

パラメーター

[in] hClientHandle

Wi-Fi Direct サービスへのクライアント ハンドル。 このハンドルは、 WFDOpenHandle 関数の以前の呼び出しによって取得されました。

[in] pDeviceAddress

ターゲット デバイスの Wi-Fi Direct デバイス アドレスへのポインター。 これは、ターゲット Wi-Fi デバイスの MAC アドレスです。

[in, optional] pvContext

pfnCallback パラメーターで指定されたコールバック関数に渡される省略可能なコンテキスト ポインター。

[in] pfnCallback

WFDStartOpenSession 要求が完了した後に呼び出されるコールバック関数へのポインター。

[out] phSessionHandle

この特定の Wi-Fi Direct セッションへのハンドル。

戻り値

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

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

リターン コード 説明
ERROR_INVALID_HANDLE
ハンドルが正しくありません。

このエラーは、 hClientHandle パラメーターで指定されたハンドルがハンドル テーブルで見つからなかった場合に返されます。

ERROR_INVALID_PARAMETER
パラメーターが正しくありません。

このエラーは、 hClientHandle パラメーターが NULL または無効な場合に返されます。 このエラーは、 pDeviceAddress パラメーターが NULLpfnCallback パラメーターが NULLphSessionHandle パラメーターが NULL の場合にも返されます。 dwClientVersion パラメーターが WFD_API_VERSION と等しくない場合も、この値が返されます。

ERROR_INVALID_STATE
グループまたはリソースが、要求された操作を実行するための正しい状態にありません。

このエラーは、ドメインのグループ ポリシーによって Wi-Fi ダイレクト サービスが無効になっている場合に返されます。

ERROR_SERVICE_NOT_ACTIVE
サービスは開始されていません。

このエラーは、WLAN AutoConfig サービスが実行されていない場合に返されます。

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

注釈

WFDStartOpenSession 関数は、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 するためのソリューションを提供することです。

WFDStartOpenSession 関数は、特定の Wi-Fi Direct デバイスへのオンデマンド接続を開始する非同期操作を開始します。 ターゲット Wi-Fi デバイスは、Windows ペアリング エクスペリエンスを通じて以前にペアリングされている必要があります。 非同期操作が完了すると、 pfnCallback パラメーターで指定されたコールバック関数が呼び出されます。

WFDStartOpenSession 関数が非同期的に完了する前に WFDCloseHandle 関数を呼び出して、アプリケーションが Wi-Fi Direct サービスへのハンドルを閉じようとすると、WFDCloseHandle 関数は WFDStartOpenSession 呼び出しが完了するまで待機します。

要件

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

こちらもご覧ください

WFDCancelOpenSession

WFDCloseHandle

WFDCloseSession

WFDOpenHandle

WFDOpenLegacySession

WFDUpdateDeviceVisibility

WFD_OPEN_SESSION_COMPLETE_CALLBACK