Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 |
|---|---|
|
La méthode a réussi. |
|
Échec de la méthode. Cela peut signifier qu’aucun appareil d’une classe spécifiée n’est associé à l’adresse actuelle. |
|
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
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi3if.h (inclure Tapi3.h) |
| Bibliothèque | Uuid.lib |
| DLL | Tapi3.dll |