SNAModemAddLink

La fonction SNAModemAddLink doit être appelée une fois par initialisation de lien. Pour les services de liaison qui prennent en charge plusieurs fois un seul lien SNA, cet appel peut être effectué plusieurs fois. Pour les services de liaison qui ne prennent en charge qu’un seul lien, cet appel peut être effectué immédiatement après SNAModemInitialize; sinon, il est préférable d’appeler SNAModemAddLink , car chaque port est initialisé.

Syntaxe

  
            void SNAModemAddLink(   
MODEM_STATUS **ppModemStatus);  

Paramètres

ppModemStatus
Adresse d’un pointeur vers une structure MODEM_STATUS qui sera utilisée pour stocker les informations d’état du modem. La structure de MODEM_STATUS retournée contient un nom de service de liaison.

Remarques

Remarque

L’IHV doit déclarer un pointeur vers une structure MODEM_STATUS et transmettre son adresse à SNAModemAddLink.

Remarque

Le nom LSName est initialement le nom du service de liaison, mais doit peut-être être modifié pour les services de liaison multiport. L’IHV peut remplacer le nom du service de liaison retourné dans la structure MODEM_STATUS pour différencier plusieurs connexions possibles par le biais d’un seul service de liaison.

Remarque

L’IHV doit conserver les différentes lignes de signal d’entrée et de sortie et le nombre d’images de flux de données dans la structure de MODEM_STATUS retournée. L’application Microsoft Host Integration Server Modem Monitor lit et affiche régulièrement les données stockées dans cette structure MODEM_STATUS.

Remarque

En interne, SNAModemAddLink incrémente le nombre d’utilisations de la mémoire partagée et signale l’application Host Integration Server Modem Monitor qu’un nouveau lien a été ajouté.

Voir aussi

MODEM_STATUS
SNAModemInitialize