Compartir a través de

Método IMbnRegistration::SetRegisterMode (mbnapi.h)

Importante

A partir de Windows 10, versión 1803, las API de Win32 descritas en esta sección se reemplazan por las API de Windows Runtime en el espacio de nombres Windows.Networking.Connectivity.

Establece el modo de registro para el dispositivo.

Sintaxis

HRESULT SetRegisterMode(
  [in]  MBN_REGISTER_MODE registerMode,
  [in]  LPCWSTR           providerID,
  [in]  ULONG             dataClass,
  [out] ULONG             *requestID
);

Parámetros

[in] registerMode

Valor MBN_REGISTER_MODE que especifica el nuevo modo de registro.

[in] providerID

Cadena que especifica el identificador de proveedor del proveedor de red al que se va a registrar. Debe ser NULL cuando se MBN_REGISTER_MODE_AUTOMATICregisterMode.

[in] dataClass

Combinación bit a bit de or MBN_DATA_CLASS valores que especifican las tecnologías de acceso a datos preferidas para la conexión. El servicio de banda ancha móvil registrará la tecnología de clase de datos más alta disponible de esta lista. Si no se puede registrar ninguna clase de datos de esta lista, el servicio de banda ancha móvil se registrará en la mejor clase de datos disponible.

[out] requestID

Identificador de solicitud establecido por el servicio de banda ancha móvil para identificar esta solicitud asincrónica.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se completó correctamente.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 El servicio de banda ancha móvil no se está ejecutando en este sistema.
E_HANDLE
 La interfaz no es válida, lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 La interfaz no es válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 Ya hay una conexión de red activa. No se puede cambiar el modo de registro mientras ya hay una conexión de datos establecida. La aplicación que llama primero debe desconectar la conexión y, a continuación, intentar cambiar el modo de registro. Si el dispositivo ya está en el modo solicitado y está conectado al proveedor solicitado, el código de retorno se S_OK.

Comentarios

El método SetRegisterMode se puede usar para establecer un dispositivo en modo de selección de red automático o manual. Para el modo de registro manual, el identificador de red al que se debe registrar el dispositivo se proporciona en providerID.

La compatibilidad con el modo de registro manual es opcional y la aplicación debe comprobar que el dispositivo admite el registro manual comprobando MBN_CTRL_CAPS_REG_MANUAL en el parámetro interfaceCaps rellenado por el método GetInterfaceCapability de IMbnInterface. Si una aplicación establece el modo de registro manual y no es compatible con el dispositivo, esta llamada devolverá HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) .

SetRegisterMode es asincrónico y se devolverá inmediatamente. Si no hay ningún error, al finalizar la operación, el servicio de banda ancha móvil llamará al método OnSetRegisterModeComplete de IMbnRegistrationEvents.

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado mbnapi.h

Consulte también

IMbnRegistration

  • Last updated on