WlanRenameProfile 関数 (wlanapi.h)

  • [アーティクル]

WlanRenameProfile 関数は、指定されたプロファイルの名前を変更します。

構文

DWORD WlanRenameProfile(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] LPCWSTR    strOldProfileName,
  [in] LPCWSTR    strNewProfileName,
       PVOID      pReserved
);

パラメーター

[in] hClientHandle

WlanOpenHandle 関数の以前の呼び出しによって取得されたクライアントのセッション ハンドル。

[in] pInterfaceGuid

インターフェイスの GUID。

[in] strOldProfileName

変更するプロファイル名。

[in] strNewProfileName

プロファイルの新しい名前。

pReserved

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

戻り値

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

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

リターン コード 説明
パラメーターのERROR_INVALID
 hClientHandle が NULL であるか無効か、 pInterfaceGuid が NULL、 strOldProfileName が NULL、 strNewProfileName が NULL、または pReserved が NULL ではありません。
ERROR_INVALID_HANDLE
 ハンドル テーブルにハンドル hClientHandle が見つかりませんでした。
ERROR_NOT_FOUND
 strOldProfileName で指定されたプロファイルがプロファイル ストアに見つかりませんでした。
ERROR_ACCESS_DENIED
 呼び出し元には、プロファイルの名前を変更するための十分なアクセス許可がありません。
ERROR_NOT_SUPPORTED
 この関数は、サポートされていないプラットフォームから呼び出されました。 この関数が SP3 の Windows XP から呼び出された場合、または SP2 クライアントを使用した Windows XP 用ワイヤレス LAN API から呼び出された場合、この値が返されます。
RPC_STATUS
 さまざまなエラー コード。

要件

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

関連項目

WlanDeleteProfile

WlanGetProfile

WlanSetProfile