Metodo IMbnServiceActivation::Activate (mbnapi.h)

Articolo
02/28/2024

Importante

A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.

Inviare la richiesta di attivazione del servizio alla rete.

Sintassi

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

Parametri

[in] vendorSpecificData

Matrice specifica del fornitore di byte passati in un'operazione di attivazione del servizio. Questi dati verranno passati dal servizio Mobile Broadband in una richiesta SET OID_WWAN_SERVICE_ACTIVATION OID al driver miniport.

[out] requestID

ID richiesta per questa operazione.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Il servizio Mobile Broadband non è in esecuzione in questo sistema.
E_HANDLE	Interfaccia non valida. Probabilmente il dispositivo è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	L'interfaccia non è valida. Probabilmente il dispositivo Mobile Broadband è stato rimosso dal sistema. Interfaccia non valida. Probabilmente il dispositivo è stato rimosso dal sistema.

Commenti

Il metodo Activate può essere usato da un'applicazione per attivare il servizio cellulare. Il formato dei dati passati in questa richiesta è specifico del fornitore.

Il campo VendorSpecificBufferSize della richiesta OID verrà impostato sulle dimensioni dei dati in SAFEARRAY, vendorSpecificData. Il contenuto del fornitoreSpecificData verrà copiato byte byte nella richiesta OID al driver.

Per altre informazioni sulle operazioni di attivazione dei servizi, vedere Il modello di driver a banda larga mobile.

Si tratta di un'operazione asincrona che restituirà immediatamente. Se il metodo restituisce senza errore, il servizio Mobile Broadband chiamerà il metodo OnActivationComplete dell'interfaccia IMbnServiceActivationEvents .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mbnapi.h

Vedi anche

IMbnServiceActivation

Condividi tramite