WlanUIEditProfile 関数 (wlanapi.h)

ワイヤレス プロファイルのユーザー インターフェイス (UI) を表示します。 この UI は、ワイヤレス ネットワーク プロファイルの詳細設定を表示および編集するために使用されます。

構文

DWORD WlanUIEditProfile(
  [in]  DWORD             dwClientVersion,
  [in]  LPCWSTR           wstrProfileName,
  [in]  GUID              *pInterfaceGuid,
  [in]  HWND              hWnd,
  [in]  WL_DISPLAY_PAGES  wlStartPage,
        PVOID             pReserved,
  [out] PWLAN_REASON_CODE pWlanReasonCode
);

パラメーター

[in] dwClientVersion

クライアントがサポートする WLAN API の最高バージョンを指定します。 WLAN_UI_API_VERSION以外の値は無視されます。

[in] wstrProfileName

表示または編集するプロファイルの名前が含まれます。 プロファイル名では大文字と小文字が区別されます。 この文字列は NULL で終わる必要があります。

指定されたプロファイルは、インターフェイス pInterfaceGuid に存在する必要があります。 つまり、プロファイルはプロファイル ストアに以前に作成および保存されている必要があり、指定されたインターフェイスに対してプロファイルが有効である必要があります。

[in] pInterfaceGuid

インターフェイスの GUID。

[in] hWnd

UI の表示を要求するアプリケーション ウィンドウのハンドル。

[in] wlStartPage

UI ダイアログ ボックスが表示されたときにアクティブなタブを指定する WL_DISPLAY_PAGES 値。

pReserved

将来利用するために予約されています。 NULL に設定する必要があります。

[out] pWlanReasonCode

UI の表示が失敗した理由を示す WLAN_REASON_CODE 値へのポインター。

戻り値

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

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

リターン コード	説明
ERROR_INVALID_PARAMETER	指定されたパラメーターの 1 つが無効です。
ERROR_NOT_SUPPORTED	この関数は、サポートされていないプラットフォームから呼び出されました。 この関数が SP3 の Windows XP から呼び出された場合、または SP2 クライアントを使用した Windows XP 用ワイヤレス LAN API から呼び出された場合、この値が返されます。
RPC_STATUS	さまざまなエラー コード。

注釈

WlanUIEditProfile がERROR_SUCCESSを返した場合、UI で行われたプロファイルに対する変更は、プロファイル ストアに保存されます。

要件

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