Méthode IMbnServiceActivation ::Activate (mbnapi.h)

Article
03/01/2024

Important

À compter de Windows 10 version 1803, les API Win32 décrites dans cette section sont remplacées par les API Windows Runtime dans l’espace de noms Windows.Networking.Connectivity.

Envoyez la demande d’activation du service au réseau.

Syntaxe

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

Paramètres

[in] vendorSpecificData

Tableau d’octets propre au fournisseur passé dans une opération d’activation de service. Ces données seront transmises par le service haut débit mobile dans une requête SET OID_WWAN_SERVICE_ACTIVATION OID au pilote miniport.

[out] requestID

ID de demande pour cette opération.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	La commande s'est correctement terminée.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Le service haut débit mobile n’est pas en cours d’exécution sur ce système.
E_HANDLE	Interface non valide. Très probablement, l’appareil a été supprimé du système.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	L’interface n’est pas valide. Très probablement, l’appareil haut débit mobile a été supprimé du système. Interface non valide. Très probablement, l’appareil a été supprimé du système.

Remarques

La méthode Activate peut être utilisée par une application pour activer le service cellulaire. Le format des données transmises dans cette demande est propre au fournisseur.

Le champ VendorSpecificBufferSize de la requête OID est défini sur la taille des données dans safeARRAY, vendorSpecificData. Le contenu de vendorSpecificData sera copié octet par octet dans la requête OID vers le pilote.

Pour plus d’informations sur les opérations d’activation de service, reportez-vous au modèle de pilote haut débit mobile.

Il s’agit d’une opération asynchrone qui retourne immédiatement. Si la méthode retourne sans erreur, le service Haut débit mobile appelle la méthode OnActivationComplete de l’interface IMbnServiceActivationEvents .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	mbnapi.h

Voir aussi

IMbnServiceActivation

Partager via