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

Article
03/02/2024

La méthode GetID retourne un identificateur d’appareil pour la classe d’appareil spécifiée associée à l’adresse actuelle.

Cette méthode est destinée uniquement aux applications C/C++. Aucune méthode correspondante n’est disponible pour les applications Visual Basic et de script.

Syntaxe

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

Paramètres

[in] pDeviceClass

Pointeur vers BSTR contenant la classe d’appareil TAPI pour laquelle des informations de configuration sont nécessaires.

[out] pdwSize

Longueur de l’identificateur d’appareil retourné.

[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_FAIL	Échec de la méthode. Cela peut signifier qu’aucun appareil d’une classe spécifiée n’est associé à l’adresse actuelle.
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 .

Références croisées TAPI 2.1 : lineGetDevConfig, lineSetDevConfig, lineGetID