IUPnPServiceAsync ::BeginInvokeAction, méthode (upnp.h)
La méthode BeginInvokeAction appelle une action sur un appareil en mode asynchrone. En outre, si un téléchargement SCPD différé et un abonnement à un événement sont acceptés et qu’il n’a pas déjà eu lieu, cette méthode lance le téléchargement SCPD.
Syntaxe
HRESULT BeginInvokeAction(
[in] BSTR bstrActionName,
[in] VARIANT vInActionArgs,
[in, optional] IUPnPAsyncResult *pAsyncResult,
[out] PULONG64 pullRequestID
);
Paramètres
[in] bstrActionName
Spécifie la méthode à appeler.
[in] vInActionArgs
Spécifie un tableau d’arguments d’entrée pour la méthode . Si l’action n’a pas d’arguments d’entrée, ce paramètre doit contenir un tableau vide. Le contenu de ce tableau est spécifique au service.
[in, optional] pAsyncResult
Pointeur vers un objet IUPnPAsyncResult . Une fois l’appel BeginInvokeAction terminé, UPnP utilise la méthode IUPnPAsyncResult ::AsyncOperationComplete pour notifier le point de contrôle.
[out] pullRequestID
Pointeur vers une valeur ULONG 64 bits utilisée pour identifier l’opération d’E/S asynchrone. Le point de contrôle doit utiliser ce handle comme cookie lors de la fin ou de l’annulation de cette opération avec EndInvokeAction.
Valeur retournée
Renvoie S_OK en cas de réussite. Sinon, la méthode retourne un code d’erreur COM défini dans WinError.h ou l’une des valeurs suivantes :
Code de retour | Description |
---|---|
|
Une autre opération asynchrone est effectuée sur cet objet IUPnPServiceAsync . Créez un autre IUPnPServiceAsync instance ou annulez l’opération en cours d’exécution à l’aide de IUPnPServiceAsync ::CancelAsyncOperation. |
|
Échec du lancement de l’opération. |
|
Cette action n’est pas prise en charge par l’appareil. |
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | upnp.h |
DLL | Upnp.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour