IUPnPServiceAsync ::BeginInvokeAction, méthode (upnp.h)

Article
03/09/2024

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
E_PENDING	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.
E_FAIL	Échec du lancement de l’opération.
UPNP_E_INVALID_ACTION	Cette action n’est pas prise en charge par l’appareil.

Note Certaines valeurs peuvent indiquer qu’une erreur a été reçue d’un appareil certifié UPnP. Pour plus d’informations, consultez Codes d’erreur d’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

IUPnPServiceAsync

IUPnPServiceAsync ::EndInvokeAction

Partager via