DOT11EXT_POST_ASSOCIATE_COMPLETION コールバック関数 (wlanihv.h)

IHV 拡張機能 DLL は Dot11ExtPostAssociateCompletion 関数を呼び出して、 の呼び出しによって開始された関連付け後操作を非同期的に完了します。 Dot11ExtIhvPerformPostAssociate IHV ハンドラー関数。

構文

DOT11EXT_POST_ASSOCIATE_COMPLETION Dot11extPostAssociateCompletion;

DWORD Dot11extPostAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hSecuritySessionID,
  [in, optional] PDOT11_MAC_ADDRESS pPeer,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

パラメーター

[in, optional] hDot11SvcHandle

オペレーティング システムがワイヤレス LAN (WLAN) アダプターを参照するために使用するハンドル。 このハンドル値は、 Dot11ExtIhvInitAdapter IHV ハンドラー関数の以前の呼び出しによって指定されました。

[in, optional] hSecuritySessionID

に対する以前の呼び出しによって返されたセキュリティ セッション識別子 (ID) のハンドル Dot11ExtIhvPerformPostAssociate IHV ハンドラー関数。

[in, optional] pPeer

IHV 拡張機能 DLL がセキュリティ操作を実行したアクセス ポイント (AP) のメディア アクセス制御 (MAC) アドレス。 このパラメーターは、 DOT11_MAC_ADDRESS 構造体として書式設定されます。

[in] dwReasonCode

関連付け後操作の完了状態に関する追加情報を提供する 値。 IHV 拡張機能 DLL では 、dwReasonCode を L2cmn.h で定義されているL2_REASON_CODE_xxxx値に設定する必要があります。

IHV 拡張機能 DLL は、 dwWin32Error パラメーターを使用して、関連付け後操作の一般的な完了状態を返します。 通常、IHV 拡張機能 DLL は 、dwReasonCode を L2_REASON_CODE_IHV_BASE から (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) までの範囲内の値に設定します。

[in] dwWin32Error

Winerror.h 内のエラー コードによって定義されている関連付け後操作の完了状態。 操作が正常に完了した場合、IHV 拡張機能 DLL は dwWin32Error を ERROR_SUCCESSに設定する必要があります。

戻り値

呼び出しが成功した場合、関数は ERROR_SUCCESSを返します。 それ以外の場合は、Winerror.h で定義されたエラー コードが返されます。

注釈

IHV 拡張機能 DLL は 、Dot11ExtPostAssociateCompletion 関数を呼び出して、次のいずれかを実行します。

• への呼び出しによって開始された関連付け後操作を完了します。 Dot11ExtIhvPerformPostAssociate IHV ハンドラー関数。
• 関連付け後の操作が完了したら、 hSecuritySessionID パラメーターによって参照されるセキュリティ セッションのポート状態の変更を示します。

  たとえば、ポートの承認状態が変更された場合、IHV 拡張機能 DLL は Dot11ExtPostAssociateCompletion を呼び出すことによってオペレーティング システムに通知できます。

• 関連付け後の操作が正常に完了した場合、IHV 拡張機能 DLL は dwReasonCode を次のいずれかに設定する必要があります。
  • L2_REASON_CODE_SUCCESS。
  • L2_REASON_CODE_IHV_BASE から (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) までの範囲の IHV 定義値。
  この状況では、IHV 拡張機能 DLL は dwWin32Error をERROR_SUCCESSに設定する必要があります。
  メモ IHV 拡張機能 DLL によって dwWin32Error がERROR_SUCCESSに設定されている場合、オペレーティング システムでは、セキュリティ セッションのポート状態が承認された状態であると見なされます。 ポートが承認された状態になると、オペレーティング システムでは、WLAN アダプターを介してすべてのデータ パケットを送信できます。
   
• 関連付け後の操作が失敗して完了した場合、IHV 拡張機能 DLL は dwReasonCode を L2_REASON_CODE_SUCCESS に設定することはできません。 代わりに、DLL で dwReasonCode を次のいずれかに設定する必要があります。
  • 適切なL2_REASON_CODE_xxxxエラー値。
  • L2_REASON_CODE_IHV_BASE から (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) までの範囲の IHV 定義値。
  このような場合、IHV 拡張機能 DLL は dwWin32Error をERROR_SUCCESSに設定することはできません。 代わりに、DLL で dwWin32Error を Winerror.h で定義された適切なエラー コードに設定する必要があります。
  メモ IHV 拡張機能 DLL で dwWin32Error が ERROR_SUCCESS に設定されていない場合、オペレーティング システムは、セキュリティ セッションのポート状態が未承認の状態であると見なします。 ポートが未承認の状態になると、オペレーティング システムでは、 Dot11ExtSendPacket IHV Extensions 関数を介して送信されたパケットを含むセキュリティ パケットを WLAN アダプター経由で送信できます。
   
• IHV 拡張機能 DLL では、Dot11ExtIhvAdapterReset 関数または Dot11ExtIhvDeinitAdapter IHV ハンドラー関数が呼び出されるたびに、関連付け後のすべての保留中の操作を取り消すには、Dot11ExtPostAssociateCompletion を呼び出す必要があります。 この場合、DLL は dwStatus パラメーターを ERROR_CANCELLED に設定する必要があります。

要件

こちらもご覧ください

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

ネイティブ 802.11 IHV ハンドラー関数

DOT11_MAC_ADDRESS

Dot11ExtSendPacket