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

Article
03/06/2024

La méthode EndInvokeAction récupère les résultats d’une opération BeginInvokeAction précédente et récupère les arguments de sortie résultants.

Syntaxe

HRESULT EndInvokeAction(
  [in, out] ULONG64 ullRequestID,
  [in, out] VARIANT *pvOutActionArgs,
  [in]      VARIANT *pvRetVal
);

Paramètres

[in, out] ullRequestID

En entrée, contient une référence à un tableau vide. Lors de la sortie, reçoit une référence au tableau d’arguments de sortie spécifiques au service. Si l’action n’a pas d’arguments de sortie, ce paramètre contient un tableau vide.

Note Effacez ce paramètre avec VariantClear.

[in, out] pvOutActionArgs

L’entrée contient une référence à un tableau vide. Lors de la sortie, reçoit une référence à un VARIANT qui contient la valeur de retour de l’action appelée.

Note Effacez ce paramètre avec VariantClear.

[in] pvRetVal

Valeur ULONG 64 bits qui correspond à l’opération BeginInvokeAction lancée avant cet appel.

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
UPNP_E_DEVICE_TIMEOUT	L’appareil n’a pas répondu dans le délai d’attente de 30 secondes.
UPNP_E_DEVICE_ERROR	Une erreur inconnue s’est produite.
UPNP_E_INVALID_ARGUMENTS	Un ou plusieurs des arguments passés ne sont pas valides.
UPNP_E_INVALID_ACTION	Cette action n’est pas prise en charge par l’appareil.
UPNP_E_ERROR_PROCESSING_RESPONSE	L’appareil a envoyé une réponse qui ne peut pas être traitée ; par exemple, la réponse a été endommagée.
UPNP_E_PROTOCOL_ERROR	Une erreur s’est produite au niveau du protocole de contrôle UPnP.
UPNP_E_TRANSPORT_ERROR	Une erreur HTTP s’est produite. Utilisez la propriété IUPnPService ::LastTransportStatus pour obtenir le code http status réel. Note Ce code d’erreur est également retourné lorsque la réponse SOAP dépasse 100 kilo-octets.

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

IUPnPService ::LastTransportStatus

IUPnPServiceAsync

IUPnPServiceAsync ::BeginInvokeAction

Partager via