ITLegacyCallMediaControl::GetID, méthode (tapi3if.h)

Article
08/26/2023

La méthode GetID obtient l’identificateur de l’appareil associé à l’appel actuel.

Cette méthode est destinée aux applications C/C++. Visual Basic et les applications de script doivent utiliser la méthode ITLegacyCallMediaControl2::GetIDAsVariant .

Syntaxe

HRESULT GetID(
  [in]  BSTR  pDeviceClass,
  [out] DWORD *pdwSize,
  [out] BYTE  **ppDeviceID
);

Paramètres

[in] pDeviceClass

Pointeur vers BSTR représentant la classe d’appareil TAPI.

[out] pdwSize

Taille en octets de l’identificateur d’appareil.

[out] ppDeviceID

Identificateur de l’appareil.

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_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.
E_POINTER	Le paramètre pdwSize ou ppDeviceID n’est pas un pointeur valide.

Remarques

L’application doit appeler ITTAPI::RegisterCallNotifications avant d’appeler cette méthode.

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

L’application doit appeler la fonction CoTaskMemFree pour libérer la mémoire allouée pour le paramètre ppDeviceID .