fonction lineGetAddressCaps (tapi.h)

Article
03/02/2024

La fonction lineGetAddressCaps interroge l’adresse spécifiée sur l’appareil de ligne spécifié pour déterminer ses capacités de téléphonie.

Syntaxe

LONG lineGetAddressCaps(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwAPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

Paramètres

hLineApp

Gérez l’inscription de l’application avec TAPI.

dwDeviceID

Périphérique de ligne contenant l’adresse à interroger.

dwAddressID

Adresse sur l’appareil de ligne donné dont les fonctionnalités doivent être interrogées. Un identificateur d’adresse est associé de façon permanente à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation.

dwAPIVersion

Numéro de version de l’API téléphonie à utiliser. Le mot d’ordre élevé contient le numéro de version principal ; le mot de faible ordre contient le numéro de version secondaire. Ce nombre est obtenu par lineNegotiateAPIVersion.

dwExtVersion

Numéro de version des extensions spécifiques au fournisseur de services à utiliser. Ce nombre peut être défini sur zéro si aucune extension spécifique à l’appareil ne doit être utilisée. Sinon, le mot d’ordre élevé contient le numéro de version principale ; et le mot d’ordre inférieur contient le numéro de version mineure.

lpAddressCaps

Pointeur vers une structure de taille variable de type LINEADDRESSCAPS. Une fois la demande terminée, cette structure est remplie d’informations sur les fonctionnalités d’adresse. Avant d’appeler lineGetAddressCaps, l’application doit définir le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible pour TAPI pour retourner des informations.

Note Si les paramètres de taille de la structure ne sont pas corrects, il est possible que les données soient remplacées. Pour plus d’informations sur la définition des tailles de structure, consultez la rubrique allocation de mémoire .

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALAPPHANDLE, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_NODEVICE.

Remarques

Les identificateurs d’adresses valides varient de zéro à un inférieur au nombre d’adresses retournées par lineGetDevCaps. Le numéro de version à fournir est le numéro de version retourné dans le cadre des fonctionnalités de l’appareil de la ligne par lineGetDevCaps.