TSPI_lineNegotiateExtVersion, fonction (tspi.h)
La fonction TSPI_lineNegotiateExtVersion retourne le numéro de version d’extension le plus élevé sous lequel le fournisseur de services peut opérer pour cet appareil, compte tenu de la plage de versions d’extension possibles.
Syntaxe
LONG TSPIAPI TSPI_lineNegotiateExtVersion(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwExtVersion
);
Paramètres
dwDeviceID
Identifie l’appareil de ligne pour lequel la négociation de version d’interface doit être effectuée. La valeur INITIALIZE_NEGOTIATION ne peut pas être utilisée pour cette fonction.
dwTSPIVersion
Numéro de version de l’interface qui a déjà été négocié pour cet appareil à l’aide de TSPI_lineNegotiateTSPIVersion. Cette fonction fonctionne selon la spécification de l’interface à ce niveau de version.
dwLowVersion
Numéro de version d’extension le plus bas sous lequel TAPI ou son application cliente peuvent fonctionner. Le mot le plus significatif est le numéro de version principale et le mot le moins significatif est le numéro de version mineure. TAPI ne valide pas ce paramètre lorsque cette fonction est appelée.
dwHighVersion
Numéro de version d’extension le plus élevé sous lequel TAPI ou son application cliente peuvent fonctionner. Le mot le plus significatif est le numéro de version principale et le mot le moins significatif est le numéro de version mineure. TAPI ne valide pas ce paramètre lorsque cette fonction est appelée.
lpdwExtVersion
Pointeur vers un DWORD. En cas de retour réussi de cette fonction, le fournisseur de services remplit cet emplacement avec le numéro de version d’extension le plus élevé, dans la plage demandée par l’appelant, sous laquelle le fournisseur de services peut fonctionner. Le mot le plus significatif est le numéro de version principale et le mot le moins significatif est le numéro de version mineure. Si la plage demandée ne chevauche pas la plage prise en charge par le fournisseur de services, la fonction retourne LINEERR_INCOMPATIBLEEXTVERSION.
Valeur retournée
Retourne zéro si la fonction réussit, ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.
Remarques
Cette fonction peut être appelée avant ou après l’ouverture de l’appareil par TAPI. Si l’appareil est actuellement ouvert et a une version d’extension sélectionnée, la fonction donne ce numéro de version s’il se trouve dans la plage demandée. Si le numéro de version sélectionné est en dehors de la plage demandée, la fonction retourne LINEERR_INCOMPATIBLEEXTVERSION.
Configuration requise
| Plateforme cible | Windows |
| En-tête | tspi.h |