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

構文

DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA Dot11extGetProfileCustomUserData;

DWORD Dot11extGetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [out]          DWORD *pdwDataSize,
  [out]          LPVOID *ppvData
)
{...}

パラメーター

[in, optional] hDot11SvcHandle

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

[in, optional] hConnectSession

基本サービス セット (BSS) ネットワークとの接続セッションを参照するためにオペレーティング システムによって使用されるハンドル。 このハンドル値は、 に対する以前の呼び出しによって指定されました。 Dot11ExtIhvPerformPreAssociate IHV ハンドラー関数。

[in] dwSessionID

現在のユーザーのセッション識別子 (セッション ID)。

[out] pdwDataSize

ppvData によって参照されるバッファーのサイズをバイト単位で格納する呼び出し元が指定した変数へのポインター。

[out] ppvData

ユーザー データを含むバッファーのアドレスを格納するポインター変数のアドレス。

戻り値

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

注釈

オペレーティング システムは、システム レジストリからデータを読み取った後、 ppvData パラメーターによって参照されるデータの暗号化を解除しません。 IHV 拡張機能 DLL では、 Dot11ExtGetProfileCustomUserData を呼び出した後、独自の復号化アルゴリズムを使用してデータを復号化する必要があります。

Native Wifi AutoConfig サービスで使用されるすべてのワイヤレス WLAN プロファイルについて、Windows ではカスタム ユーザー データの概念が維持されます。 このカスタム ユーザー データは、最初は存在しないが、 を呼び出すことによって設定できます。 Dot11ExtSetProfileCustomUserData 関数。 カスタム ユーザー データは、 を呼び出してプロファイルが変更されるたびに空にリセットされます。 Dot11ExtSetCurrentProfile 関数。

カスタム ユーザー データが設定されたら、 Dot11ExtGetProfileCustomUserData 関数を使用してこのデータにアクセスできます。

呼び出し元は、Dot11ExtFreeBuffer 関数を使用して、ppvData パラメーターによって指されるバッファーに割り当てられたメモリを解放する役割を担います。

要件

こちらもご覧ください

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtSetCurrentProfile