Método IMbnServiceActivation::Activate (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.

Envíe la solicitud de activación del servicio a la red.

Sintaxis

HRESULT Activate(
  [in]  SAFEARRAY *vendorSpecificData,
  [out] ULONG     *requestID
);

Parámetros

[in] vendorSpecificData

Matriz específica del proveedor de bytes pasada en una operación de activación de servicio. El servicio de banda ancha móvil pasará estos datos en una solicitud set OID_WWAN_SERVICE_ACTIVATION OID al controlador de minipuerto.

[out] requestID

Identificador de solicitud para esta operación.

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	Interfaz no válida. Lo más probable es que el dispositivo 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. Interfaz no válida. Lo más probable es que el dispositivo se haya quitado del sistema.

Comentarios

Una aplicación puede usar el método Activate para activar el servicio de telefonía móvil. El formato de los datos pasados en esta solicitud es específico del proveedor.

El campo VendorSpecificBufferSize de la solicitud OID se establecería en el tamaño de los datos de SAFEARRAY, vendorSpecificData. El contenido de vendorSpecificData se copiará byte-byte en la solicitud OID al controlador.

Consulte el modelo de controlador de banda ancha móvil para obtener más información sobre las operaciones de activación del servicio.

Se trata de una operación asincrónica que devolverá inmediatamente. Si el método devuelve sin error, el servicio de banda ancha móvil llamará al método OnActivationComplete de la interfaz IMbnServiceActivationEvents .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	mbnapi.h

Consulte también

IMbnServiceActivation