ITBasicCallControl::P arkDirect, méthode (tapi3if.h)

Article
08/26/2023

La méthode ParkDirect parse l’appel à une adresse spécifiée.

Syntaxe

HRESULT ParkDirect(
  [in] BSTR pParkAddress
);

Paramètres

[in] pParkAddress

Pointeur vers BSTR contenant l’adresse où l’appel doit être parqué.

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi.
E_POINTER	Le paramètre pParkAddress n’est pas un pointeur valide.
E_FAIL	Le parc n’est pas pris en charge.
E_INVALIDARG	Le paramètre pParkAddress n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.
TAPI_E_TIMEOUT	L’opération a échoué car la DLL TAPI 3 a expiré. L’intervalle de délai d’expiration est de deux minutes.

Remarques

Certains fournisseurs de services ne prennent pas en charge cette opération pendant que la diffusion en continu est active. L’application peut avoir besoin d’appeler ITStream::StopStream ou ITSubStream::StopSubStream avant l’opération et ITStream::StartStream ou ITSubStream::StartSubStream une fois l’opération terminée.

Avec le parc dirigé, l’application détermine l’adresse à laquelle elle souhaite parquer l’appel. Avec ParkInDirect, le commutateur détermine l’adresse et la fournit à l’application. Dans les deux cas, un appel parqué peut être annulé en spécifiant cette adresse.

L’appel parqué passe à l’état déconnecté une fois qu’il a été garé avec succès.

Certains commutateurs peuvent rappeler à l’utilisateur une fois qu’un appel a été garé pendant un certain temps. L’application voit un appel d’offre avec une raison d’appel définie sur rappel.

L’application doit utiliser SysAllocString pour allouer de la mémoire au paramètre pParkAddress et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.