Función WlanRenameProfile (wlanapi.h)

La función WlanRenameProfile cambia el nombre del perfil especificado.

Sintaxis

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

Parámetros

[in] hClientHandle

Identificador de sesión del cliente, obtenido por una llamada anterior a la función WlanOpenHandle .

[in] pInterfaceGuid

GUID de la interfaz.

[in] strOldProfileName

Nombre del perfil que se va a cambiar.

[in] strNewProfileName

Nuevo nombre del perfil.

pReserved

Reservado para uso futuro. Debe establecerse en NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de retorno.

Código devuelto	Descripción
parámetro de ERROR_INVALID	hClientHandle es NULL o no válido, pInterfaceGuid es NULL, strOldProfileName es NULL, strNewProfileName es NULL o pReserved no es NULL.
ERROR_INVALID_HANDLE	No se encontró el identificador hClientHandle en la tabla handle.
ERROR_NOT_FOUND	El perfil especificado por strOldProfileName no se encontró en el almacén de perfiles.
ERROR_ACCESS_DENIED	El autor de la llamada no tiene permisos suficientes para cambiar el nombre del perfil.
ERROR_NOT_SUPPORTED	Se llamó a esta función desde una plataforma no admitida. Este valor se devolverá si se llamó a esta función desde un Windows XP con SP3 o la API de LAN inalámbrica para Windows XP con el cliente SP2.
RPC_STATUS	Varios códigos de error.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wlanapi.h (incluya Wlanapi.h)
Library	Wlanapi.lib
Archivo DLL	Wlanapi.dll

Consulte también

WlanDeleteProfile

WlanGetProfile

WlanSetProfile