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 です。
関数が失敗した場合、戻り値は次のいずれかの戻りコードになる可能性があります。
リターン コード | 説明 |
---|---|
|
hClientHandle が NULL であるか無効か、 pInterfaceGuid が NULL、 strOldProfileName が NULL、 strNewProfileName が NULL、または pReserved が NULL ではありません。 |
|
ハンドル テーブルにハンドル hClientHandle が見つかりませんでした。 |
|
strOldProfileName で指定されたプロファイルがプロファイル ストアに見つかりませんでした。 |
|
呼び出し元には、プロファイルの名前を変更するための十分なアクセス許可がありません。 |
|
この関数は、サポートされていないプラットフォームから呼び出されました。 この関数が SP3 の Windows XP から呼び出された場合、または SP2 クライアントを使用した Windows XP 用ワイヤレス LAN API から呼び出された場合、この値が返されます。 |
|
さまざまなエラー コード。 |
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wlanapi.h (Wlanapi.h を含む) |
Library | Wlanapi.lib |
[DLL] | Wlanapi.dll |