Fonction APUFindPrinterInstance()

Recherche la première instance de l'outil d'impression d'alarmes utilisant le nom d'imprimante ou de port spécifiés.

Catégorie

Affichage

Syntaxe

[Result=] APUFindPrinterInstance(sPrinter, iInstance);

Arguments

sPrinter

Le nom de l'imprimante utilisée par l'instance recherchée.

iInstance

Une variable de type entier renseignée par le numéro de l'instance.

Remarques

La fonction renvoie le numéro d’instance dans une variable de type entier spécifiée par le paramètre d’instance. Utilisez cette fonction pour obtenir initialement l'instance souhaitée de l'outil d'impression. Le nom de l'imprimante est conservé et lu depuis le fichier ALC. La chaîne du nom de l'imprimante n'est pas sensible à la casse. Si aucune instance n'est retrouvée, la fonction renvoie le code d'erreur 1 (aucune instance disponible) et définit la variable entière avec la valeur 0.

Renvoie un code d'erreur de type entier.

Exemple

FoundInst est une variable de type entier renseignée avec le numéro de la première instance retrouvée qui utilise le nom d'imprimante LPT1 dans le fichier .alc associé.

Status = APUFindPrinterInstance("LPT1", FoundInst);

Voir aussi

APUFindAlarmGroupInstance(), APUFindFileInstance(), APUGetInstanceCount(), APUIsInstanceUsed()