Kix 2010

Machine
Machine Translated
Traduit parby Google
Google
KiXtart2010 1
KiXtart2010 (version 4.66)
…C'est plein de scripts...
Heureux
Introduction 3
Quoi de neuf 3
KiXtart : Cela vous intéresse ? 4
Configuration système requise 8

KiXtart 2010 Fichiers 8
Installation de KiXtart 8
Pour installer KiXtart sur le réseau 8
Pour installer KiXtart sur un client 8
Désinstallation de KiXtart 9
Mise à jour à partir des versions précédentes 9
Exécuter KiXtart 9
Exécuter KiXtart à partir d'un fichier batch 10
Scripts de prétokenisation 10
Localisation des fichiers 11
Dépannage de KiXtart 12
Introduction 12
Problèmes courants 12
Mode débogage 13
Divers… 13
KiXtart et la console 13
Automatisation COM dans KiXtart 2010 14
Informations sur l'adhésion au groupe. 16
Règles de syntaxe générales 17
Commentaires sur les blocs
18 Variables de programme dynamiques
18 Expressions
21 Référence des commandes KiXtart 25
Référence des fonctions KiXtart 47
Valeurs de retour 47
Fonctions de registre 47
Machine
Machine Translated
Google
2 KiXtart2010
Référence des macros KiXtart 108
Implémentation de l'automatisation KiXtart COM 113

Installation de l'implémentation KiXtart COM 113
Utilisation de l'implémentation KiXtart COM 113
Méthodes KiXtart COM 113
Propriétés KiXtart COM 116

ANNEXE A : Gestion des erreurs 118
Où trouver plus d'informations 119
Remerciements 120
À propos de KiXtart 121
Avis de nonresponsabilité et informations de distribution. 121

Machine Translated
Machine Traduit par Google by Google
KiXtart2010 3
Introduction
KiXtart est un processeur de script de connexion et un langage de script par lots amélioré pour les ordinateurs exécutant Windows Server 2012
(R2), Windows Server 2008 (R2), Windows 10, Windows 8.x, Windows 7, Windows Vista, Windows Server 2003 ou Windows XP dans un
Environnement réseau Windows. Le langage de script au format libre KiXtart peut être utilisé pour afficher des informations, définir des
variables d'environnement, démarrer des programmes, se connecter à des lecteurs réseau, lire ou modifier le registre, modifier le lecteur et le
répertoire actuels et bien plus encore.
KiXtart a été développé par Ruud van Velsen de Microsoft PaysBas.
quoi de neuf
KiXtart 2010 est basé sur KiXtart 2001 et KiXtart 95 et est conçu pour être entièrement rétrocompatible.
Toutes les fonctionnalités fournies par KiXtart 2001 et la plupart des fonctionnalités fournies par KiXtart 95 sont disponibles avec KiXtart 2010.
KiXtart 2010 est une mise à jour majeure avec divers correctifs et améliorations ainsi que quelques nouvelles fonctionnalités.
Veuillez consulter les paragraphes suivants pour une liste des correctifs et des nouvelles fonctionnalités ajoutées depuis KiXtart 2001.
KiXtart 2010 vous est fourni sous forme de CareWare. Veuillez consulter le paragraphe intitulé « KiXtart : Do You Care » pour plus de
détails et rejoignez la communauté croissante de supporters KiXtart CareWare !
Commandes, fonctions et macros améliorées

Un scanner
Correction d'un problème avec les expressions contenant plusieurs appels AScan.
CASSER
Correction de la gestion des paramètres invalides.
Couleurs des consoles
Correction de la réinitialisation des couleurs de la console suite à une erreur de script.
COPIE
Amélioré pour permettre la copie d'un seul fichier dans un répertoire inexistant.
AFFICHER
Correction d'un problème d'affichage des fichiers de plus de 26 Ko.
SORTIE
Correction de la gestion des codes de sortie.
@LOGONMODE Corrigé.
MOVE Amélioré pour lui permettre d'écraser les fichiers ciblés via un UNC.
@PRODUCTTYPE Amélioré pour prendre en charge les nouvelles versions de Windows.
ReadLine Correction pour gérer des fichiers volumineux (64 Mo+).
Remplacer Nouvelle fonction pour remplacer les caractères/chaînes dans les
chaînes SendKeys Correction de la régression introduite dans la version 4.52.
SetOption Nouvelles options pour désactiver/activer le registre et la redirection de fichiers sur les éditions x64 de
Des fenêtres ont été ajoutées.
USE LIST Supporte désormais l'indicateur /persistent.

UTILISER * /delete Amélioré pour supprimer les connexions persistantes et déconnectées.
Wow64fileredirection Valeur par défaut fixe sur « ON ».
De plus, à partir de cette version, KiXtart est également disponible sous la forme d'un composant COM qui permet d'exécuter des scripts
KiXtart à partir de n'importe quelle application Windows prenant en charge l'automatisation COM.
Pour plus d'informations sur les modifications de dernière minute apportées à KiXtart 2010, consultez Kix2010.txt, dans le sousrépertoire Kix32.
Machine Translated
4 KiXtart2010
KiXtart : Cela vous intéresse ?
Introduction
KiXtart a été lancé en 1991 en tant que projet de temps libre en réponse aux nombreuses demandes de scripts de connexion.
fonctionnalité pour l'environnement Microsoft LAN Manager. La simplicité, la rapidité et l'absence de concurrence de KiXtart l'ont
rapidement rendu très populaire auprès des administrateurs réseau LAN Manager.
KiXtart a été initialement distribué sous forme de logiciel gratuit via des forums d'affichage en Europe. Plus tard, les sites Internet ont repris KiXtart
et ont lancé des listes de distribution, des forums de discussion et des archives de scripts. KiXtart a également été fourni dans le cadre de plusieurs
kits de ressources Microsoft. Au fil du temps, KiXtart a grandi, tant en popularité qu'en fonctionnalités. La prise en charge de
Windows NT et Windows 95 a été ajoutée, ainsi que de nombreuses nouvelles fonctions et fonctionnalités.
Aujourd'hui, des milliers d'organisations dans le monde utilisent KiXtart. Banques, compagnies d'assurance, collèges, universités,
hôpitaux, centrales électriques, organisations gouvernementales, sociétés informatiques, constructeurs automobiles, compagnies pétrolières,
industries aérospatiales, éditeurs, parcs d'attractions, sociétés de radiodiffusion et bien d'autres.
d'autres types d'organisations à travers le monde utilisent quotidiennement KiXtart pour configurer des postes de travail, installer
logiciel et effectuer de nombreuses autres tâches de script.
KiXtart est également devenu un sujet brûlant sur divers forums de discussion Internet, avec de nombreux participants enthousiastes
partageant des conseils, des astuces et des scripts.
Au fil des années, de nombreuses personnes se sont demandé quand KiXtart serait commercialisé. En fait, les demandes d'informations
sur les prix et les licences sur KiXtart sont assez courantes.
À tout le moins, tout cela prouve que KiXtart a une valeur.
Plutôt que de commercialiser KiXtart, j'aimerais transformer sa valeur en quelque chose de vraiment positif.
Plus précisément, j'aimerais utiliser sa valeur pour aider les personnes qui ont absolument besoin et méritent notre soutien : le peuple du Népal.
Dans le cadre de cette initiative, KiXtart 2010 vous est proposé sous le nom de CareWare. Ce que cela signifie exactement est détaillé dans les
paragraphes suivants. Veuillez lire attentivement les informations et soutenir l'initiative KiXtart CareWare !
Qu’estce que CareWare ?
CareWare est une variante du shareware et du freeware. Il est parfois également appelé « logiciel caritatif », « donationware », «
helpware » ou « goodware ». Il s'agit d'un logiciel protégé par le droit d'auteur que vous êtes autorisé à utiliser gratuitement en échange d'un
don à un ou plusieurs organismes de bienfaisance spécifiés ou à un organisme de bienfaisance de le choix des utilisateurs.
KiXtart CareWare peut être téléchargé, installé et évalué gratuitement. Si vous continuez à utiliser KiXtart, vous êtes prié de faire un don à une
organisation caritative à but non lucratif. Une liste des organismes de bienfaisance préférés est fournie cidessous.
Combien devrionsnous donner ?
La réponse à cette question est dans votre cœur. Le montant du don doit refléter votre perception de la valeur de KiXtart pour votre
organisation. Le montant minimum du don suggéré est de cinquante dollars américains (50 $)
Machine Translated
KiXtart2010 5
par organisation/entreprise utilisant KiXtart. Veuillez considérer que CareWare n'a pas pour but de gagner de l'argent, mais de partager avec
d'autres personnes et de prendre soin d'elles.
Faire un don est plus important que le montant réel du don.
Notez que dans de nombreux pays, les dons caritatifs à des organisations caritatives officiellement enregistrées sont déductibles des impôts, vous pourrez donc
peutêtre donner plus que vous ne le pensez !
À qui devrionsnous faire un don ?
Les organisations caritatives à but non lucratif suivantes qui soutiennent la population du Népal sont privilégiées :
http://www.roomtoread.org/
Room to Read cherche à offrir à chaque enfant la possibilité d'acquérir le don permanent de l'alphabétisation en s'attaquant
les causes profondes de l'analphabétisme dans la société népalaise.
Un groupe dévoué de bénévoles non rémunérés a créé la fondation en 1998. Un village à la fois, une école à la fois, le projet Books for Nepal
s'adresse aux communautés pour leur offrir l'éducation.
http://www.rokpa.org
ROKPA INTERNATIONAL est une organisation à but non lucratif qui aide et soutient les personnes en situation de manque de respect envers leur
nationalité, religion ou origine culturelle.
ROKPA INTERNATIONAL travaille dans les domaines de l'éducation, des soins de santé, de la lutte contre la faim et de la préservation de la culture,
de l'entraide et de l'écologie. L'organisation propose à la fois une aide d'urgence et une aide à long terme à travers ses projets au Népal,
Tibet et autres pays.
Si, pour une raison quelconque, vous ne pouvez pas faire de don à ces organisations particulières, vous êtes priés de faire un don à
L'Unicef à la place :
Machine Translated
6 KiXtart2010
http://www.unicef.org
Depuis plus de 53 ans, l'UNICEF aide les gouvernements, les communautés et les familles à rendre le monde meilleur pour les
enfants. Faisant partie du système des Nations Unies, l'UNICEF a un mandat et une mission enviables : défendre les droits
des enfants et aider à répondre à leurs besoins.
Remarque : plus de détails sur ces organisations peuvent être trouvés dans l'annuaire GuideStar.
Pourquoi le Népal ?
Lorsque j'ai visité le Népal pour la première fois en 1999, j'ai été enchanté par sa beauté magnifique et par sa gentillesse et
des gens hospitaliers. En même temps, j'étais abasourdi par la pauvreté.
Le Népal, qui abrite le mont Everest, est l'un des pays les plus pauvres du monde, en termes relatifs et absolus. Plus de la moitié
de la population vit en dessous du seuil de pauvreté et plus de 80 % de la population vit avec moins de 2 dollars par jour. Le Népal
possède peu de ressources naturelles en dehors de sa beauté et de sa population travailleuse. L'espérance de vie est très faible
et l'analphabétisme touche plus de 50 % des enfants. L’éducation, les médicaments et même des choses de base comme l’eau
potable sont un luxe dans une grande partie du Népal. De plus, la malnutrition est un problème répandu dans tout le Népal.
Qu'estce que je reçois en retour?

Bien entendu, le concept même de CareWare consiste à donner et non à recevoir. Cependant, faire un don au nom de KiXtart offre
les avantages suivants :
• Des personnes ailleurs dans le monde bénéficient de votre soutien.
• Vous vous sentez bien en utilisant KiXtart.
• Vous motivez le développement continu de KiXtart.
De plus, si vous choisissez d'enregistrer votre don, vous serez tenu au courant des développements de KiXtart et le nom de votre
(entreprise) pourra être inclus dans la liste des sponsors de KiXtart CareWare. Voir cidessous pour plus de détails sur la façon
d'enregistrer votre don.
Comment doiton faire un don ?
Pour faire un don, sélectionnez simplement l'organisation que vous souhaitez soutenir, déterminez le montant que vous pouvez
donner et utilisez l'une des méthodes de don soutenues par l'organisation.
Lorsque vous faites un don, veuillez inclure une référence à « KiXtart 2010 ».
En option, vous pouvez également enregistrer votre don en transmettant l'email de confirmation que vous envoyez ou recevez de
l'organisation caritative à ruudv@microsoft.com.
Machine
Machine Translated
Google
KiXtart2010 7
Je ne peux pas faire de don à une œuvre caritative !
Si vous n'êtes pas en mesure de donner de l'argent à un organisme de bienfaisance, pour quelque raison que ce soit, j'apprécierais que vous me disiez pourquoi.
Comprendre quel est le problème lié au don me permettra d'améliorer KiXtart CareWare
processus.
Je m'en fiche…
C'est entièrement votre prérogative. L'initiative KiXtart CareWare est basée sur votre coopération volontaire.
KiXtart n'a pas de processus d'enregistrement intégré ni de vérification de licence.
Veuillez examiner attentivement la valeur de KiXtart pour vous et votre organisation, et reconsidérer la possibilité de faire un don.
Votre soutien sera grandement apprécié par moi et, plus important encore, par les organisations auxquelles vous faites un don et les personnes qu'elles
soutiennent. Rejoignez le nombre croissant de supporters KiXtart CareWare dès aujourd'hui !
CareWare fonctionne !
Au fil des années, vous avez été nombreux à soutenir l'initiative KiXtart CareWare et à faire des dons à diverses
organisations dans le monde entier. Votre soutien a notamment permis
RoomtoRead va construire plusieurs écoles au Népal exclusivement financées par les dons des utilisateurs de KiXtart ! De plus, RoomtoRead a utilisé votre
soutien pour créer des livres de lecture pour enfants indispensables en langue népalaise. S'il te plaît
voir Publications en langue locale accessibles à la lecture pour plus d'informations sur ces résultats passionnants du monde réel.
CareWare fonctionne réellement ; si vous soutenez déjà l'initiative, veuillez accepter mes sincères remerciements pour votre
soutien. Si vous n'avez pas encore fait de don, veuillez prendre quelques instants et commencer à soutenir KiXtart CareWare.
initiative aujourd'hui !
Machine Translated
8 KiXtart2010
Configuration système
requise KiXtart 2010 est pris en charge sur les systèmes dotés d'un microprocesseur Intel 80486 ou supérieur exécutant Windows
Server 2012 (R2), Windows Server 2008 (R2), Windows 10, Windows 8.1, Windows 7, Windows Server 2003, Windows Vista
ou Windows XP. .
Des versions plus anciennes de KiXtart pour Windows 2000, Windows NT, Windows 98, Windows 95 et même MSDOS sont également
disponibles. Veuillez consulter le site Web suivant pour connaître les dernières versions disponibles :
http://kixtart.org
Fichiers KiXtart 2010
Le fichier zip KiXtart 2010 contient les fichiers suivants.
Kix2010.doc Ce document
Kix32.exe
Fichier programme KiXtart 2010 (version console)
WKix32.exe
Fichier programme KiXtart 2010 (version sans console)
KiXtart.dll
Fichier de programme COM KiXtart 2010
*.kix
Exemples de fichiers de script
*.spk Exemples de fichiers SPK
Kix2010.txt
Notes de version, contenant des informations sur les dernières
modifications apportées à KiXtart 2010
Installation de KiXtart
KiXtart est disponible en trois « saveurs » :
• Kix32.exe, la version console standard de KiXtart
• Wkix32.exe, une version de KiXtart qui ne nécessite pas de console
• KiXtart.dll, une implémentation COM de KiXtart accessible depuis n'importe quelle application
qui prend en charge l'automatisation COM
Tous les composants exécutables peuvent être installés et exécutés depuis le réseau ou depuis le disque dur local des systèmes clients.
Notez que l'implémentation COM de KiXtart, fournie dans KiXtart.dll est un produit autonome. Ce n'est pas requis par Kix32 ou vice versa. Les
détails sur l'installation et l'utilisation de l'implémentation COM sont fournis dans le chapitre KIXCOM.
Pour installer KiXtart sur le réseau
Pour installer KiXtart sur le réseau, copiez les fichiers requis sur le partage NETLOGON du ou des serveurs de connexion.
Pour installer KiXtart sur un client
Pour installer KiXtart sur un client, copiez les fichiers requis dans un répertoire du disque dur local.
Machine Translated
KiXtart2010 9
Désinstaller KiXtart
Pour désinstaller KiXtart, supprimez simplement les composants exécutables et les scripts.
Mise à jour à partir des versions précédentes
Pour mettre à jour KiXtart, remplacez simplement KIX32.EXE.
Exécuter KiXtart
KiXtart peut être exécuté manuellement ou automatiquement pendant la séquence de connexion.
Pour exécuter KiXtart manuellement
À l'invite de commande, tapez la commande suivante :

kix32
Par défaut, KiXtart recherche automatiquement un script personnel pour l'utilisateur actuel (« Nom d'utilisateur.KIX »). S'il n'en trouve
pas, il recherche le script par défaut, "KIXTART.KIX". Vous pouvez remplacer ce comportement en spécifiant un ou plusieurs
scripts après Kix32.exe sur la ligne de commande.
L'état global de KiXtart est conservé tant que le processus KiXtart s'exécute. Cela signifie que si vous spécifiez plusieurs scripts sur la ligne
de commande, toutes les variables globales et fonctions définies par l'utilisateur que vous avez définies dans un script seront également
disponibles pour tous les scripts suivants.
Extensions par défaut
Si vous n'incluez pas d'extension avec un nom de script, KiXtart tente d'utiliser deux extensions par défaut : « .KX » et « .KIX ». Notez que
KiXtart 2010 n'utilise plus l'extension ".SCR".
KiXtart prend également en charge la déclaration de variables à l'invite de commande, comme le montre l'exemple suivant :
kix32 Démo.kix $Key=HKEY_LOCAL_MACHINE\Software

Pour plus d'informations sur les noms et valeurs de variables valides, voir « Variables de programme dynamiques » plus loin dans ce
document.
KiXtart prend en charge les commutateurs de ligne de commande suivants : Active

d
le mode débogage.
f[:aaaa/mm/jj] Actualise le cache d'appartenance au groupe.

je
Mode invisible. Empêche KiXtart d'afficher une fenêtre de console.
Remarque : disponible uniquement dans la version Windows de KiXtart.

t
Mode de tokenisation. Cela amènera KiXtart à prétokeniser le(s)
script(s) au lieu de les exécuter.
Voir le paragraphe sur la prétokenisation pour plus de détails.

u
(Déverrouiller) le mot de passe. Cette option vous permet de spécifier un
Machine Translated
dix KiXtart2010
mot de passe pour chiffrer ou déchiffrer un script prétokenisé. Le mot de

passe peut avoir n'importe quelle longueur.
Voir le paragraphe sur la prétokenisation pour plus de détails.

?
Afficher l'utilisation de la ligne de commande KiXtart.
Pour exécuter Kix32.exe automatiquement lorsqu'un utilisateur se connecte
1.Ouvrez Utilisateurs et ordinateurs et sélectionnez l'utilisateur.
2.Cliquez avec le bouton droit, sélectionnez Propriétés, puis sélectionnez l'onglet Profil.
3. Dans la zone Script de connexion, tapez « Kix32 ».
Exécuter KiXtart à partir d'un fichier batch
Kix32.exe peut être exécuté à partir d'un fichier de commandes utilisé comme script de connexion pour l'utilisateur. Par exemple, si
Kix32.exe se trouve dans le répertoire racine du partage NETLOGON, le fichier batch peut contenir les commandes suivantes :
@ÉCHO OFF
%0\..\Kix32.exe
L'utilisation de la syntaxe %0\..\ est abordée dans l'article Q121387 de la base de connaissances.
Si Kix32.exe a été installé sur le disque dur local du client, vous devez vous référer au répertoire local, par exemple : C:
\Kixtart\Kix32.exe.
Scripts de prétokenisation
KiXtart 2010 fournit une option pour prétokeniser les scripts. Cette fonctionnalité prend un script de texte clair et normal, le convertit en
« jetons » et stocke le résultat dans un nouveau fichier. Les scripts tokenisés sont plus petits et peuvent être traités plus rapidement que les scripts
en texte clair. De plus, les scripts tokenisés sont chiffrés et contiennent une signature pour se protéger contre les modifications accidentelles du script.
Ces fonctionnalités offrent un niveau de sécurité indisponible avec les scripts en texte clair.
Le niveau de sécurité fourni par la tokenisation d'un script est qualifié d'« obsfucation ». En termes pratiques, cela signifie que les scripts tokenisés sont
parfaitement à l'abri des tentatives de visualisation ou de modification de la part des utilisateurs finaux réguliers.
Cependant, les scripts tokenisés ne sont pas à l’abri des attaques de personnes disposant de suffisamment de temps et de détermination. En règle
générale, vous ne devez jamais stocker de données précieuses ou sensibles, telles que des mots de passe administratifs, dans des scripts (y
compris des scripts tokenisés).
Une protection supplémentaire des scripts peut être obtenue en utilisant l'option de protection par mot de passe. Les scripts protégés par un mot
de passe ne peuvent être utilisés qu'en spécifiant le mot de passe correct sur la ligne de commande KiXtart.
Machine Translated
KiXtart2010 11
Pour prétokeniser un script, spécifiez simplement l'option '/t' sur la ligne de commande :
Démo KIX32.kix /t
Pour prétokeniser un script et le protéger avec un mot de passe, combinez l'option '/t' avec l'option '/u' sur la ligne de commande :
Démo KIX32.kix /t /u=YourSecretPassword
Les scripts tokenisés sont stockés en utilisant le nom de fichier d'origine suivi de l'extension « .kx ». L'exemple cidessus produirait un
fichier portant le nom « demo.kx ».
À l'aide de l'instruction INCLUDE, vous pouvez combiner plusieurs scripts en un seul script prétokenisé.
Les scripts tokenisés peuvent être exécutés à partir de la ligne de commande KiXtart ainsi qu'en utilisant la commande CALL. Notez
cependant que CALL ne peut pas être utilisé pour exécuter des fichiers tokenisés qui ont été protégés par un mot de passe.
KiXtart ne fournit pas de moyen de reconvertir les scripts prétokenisés en scripts de texte clair. Si vous utilisez la fonctionnalité de pré
tokénisation, assurezvous toujours de conserver des copies des scripts sources d'origine.
Localisation de fichiers
Pendant la séquence de connexion, KiXtart essaie automatiquement de localiser tous les fichiers qu'il est invité à ouvrir (SPK, WAV,
TXT, etc.) en les recherchant d'abord sur le lecteur NETLOGON, puis sur le lecteur à partir duquel KiXtart a été démarré, et enfin
dans le répertoire courant. Ce comportement peut être remplacé en faisant précéder le nom de fichier d'une lettre de lecteur
ou d'un chemin UNC.
Par exemple, la commande suivante :
lire le fichier "Jbond.spk"
oblige KiXtart à rechercher Jbond.spk sur le partage NETLOGON, dans le répertoire de démarrage de KiXtart et dans le répertoire actuel.
Si cette commande est utilisée :
lire le fichier "C:Jbond.spk"
KiXtart recherche Jbond.spk uniquement dans le répertoire actuel du lecteur C.
Notez que les fonctions basées sur les API Windows natives telles que ReadProfileString et WriteProfileString utilisent un algorithme
différent pour localiser les fichiers et rechercheront le répertoire dans lequel Windows a été installé si aucun chemin de recherche n'a
été spécifié.
Machine
Machine Translated
Google
12 KiXtart2010
Dépannage de KiXtart
Introduction
KiXtart fournit une journalisation approfondie des erreurs système, telles que l'échec de la localisation des DLL de support, l'échec de la connexion
au service RPC, etc. Sur les ordinateurs exécutant Windows NT, ces erreurs sont enregistrées dans le journal des événements système.
KiXtart prend en charge la nouvelle fonctionnalité automatique DrWatson de Windows. Si vous rencontrez une erreur d'exception avec KiXtart et
que la boîte de dialogue DrWatson s'affiche, veuillez sélectionner l'option « Envoyer le rapport ». Cela facilitera la recherche et la résolution de tout
problème dans KiXtart.
Problèmes courants
Le tableau suivant décrit les problèmes les plus courants rencontrés par KiXtart.
Erreur Solution
Signification
KiXtart n'a pas réussi à trouver un Assurezvous qu'une interface NetBIOS est disponible
La macro @ADDRESS renvoie
une chaîne vide (""). Interface NetBIOS sur n’importe sur une des reliures.
quelle liaison réseau.
KiXtart ne peut pas récupérer le
La macro @FULLNAME renvoie Vérifiez le journal des événements ou kixtart.log pour tout
informations sur le réseau. les erreurs.
une chaîne vide
("").
KiXtart ne reconnaît pas certaines Bien que KiXtart soit un langage Mettez les littéraux entre guillemets.
commandes.
au format libre, certains littéraux, tels
que les noms de serveurs contenant
un trait d'union (), peut provoquer des erreurs.
Des erreurs telles que « Étiquette non

Il y a probablement un Relisez votre script.
trouvé" ou "Inconnu
guillemet sans correspondance ou une
erreur similaire quelque part dans le
command" apparaissent dans
un script par ailleurs irréprochable. scénario.
Erreur d'application Le système d'exploitation n'a pas réussi à Assurezvous de ne pas déconnecter ou rediriger
c0000006H / lire le code de l'exécutable en aucun cas le lecteur de
'IN_PAGE_ERROR' / fichier(s) car le lecteur de lequel KIX32.EXE a été démarré. De plus, ces défauts
'SWAP_ERROR' ou un défaut démarrage KiXtart est devenu peuvent être provoqués par un logiciel antivirus.
indisponible.
de page invalide est Si vous utilisez un logiciel antivirus, assurezvous
généré par intermittence. que vous utilisez la dernière version et si le problème
persiste, testez si la désactivation du logiciel
antivirus résout le problème.
Enfin, si vous utilisez la version Windows de

KiXtart (WKIX32.EXE) dans un fichier batch,
assurezvous de l'exécuter à l'aide de la commande
START avec /W et /B.
choix.
Machine Translated
KiXtart2010 13
Pour inclure des guillemets dans une chaîne, utilisez la fonction CHR ou placez la chaîne entière entre guillemets. Par exemple,
"Chaîne avec un guillemet (') dedans."
or:
"
"dedans."
"Chaîne avec guillemet double + Chr(34) +
Mode débogage
KiXtart fournit des fonctionnalités de débogage de base. En mode débogage, un script peut être exécuté instruction par instruction, la
valeur des variables ou des macros peut être affichée et vous pouvez exécuter des commandes de script arbitraires. Pour exécuter un
script en mode débogage, spécifiez «/d» sur la ligne de commande. Vous pouvez également entrer et quitter le mode débogage n'importe où dans un
script à l'aide des commandes DEBUG ON et DEBUG OFF.
Remarque : le mode débogage peut être complètement désactivé depuis un script en utilisant SetOption( "DisableDebugging", "On").
En mode débogage, la ligne supérieure de l'écran est utilisée pour afficher la ligne actuelle dans le script commençant à l'instruction actuelle.
En option, la deuxième ligne de l'écran est utilisée pour afficher la valeur d'une variable spécifique
macroor.
En mode débogage, les clés suivantes sont disponibles pour contrôler l'exécution du script :
F5
Exécuter (désactive le mode débogage, exécute le reste du script jusqu'à la fin ou jusqu'à ce qu'une commande
DEBUG ON soit rencontrée).
F8, <Espace>, <Entrée> Entrez (exécutez une seule instruction, suivez le fil de discussion dans les sousprogrammes, les UDF et
les scripts secondaires).
F10
Passer audessus (exécuter une seule instruction, s'exécuter, mais ignorer les sousprogrammes, les UDF,
et scripts secondaires en ce qui concerne le débogueur).
\ (barre oblique inverse) Vous permet d'interroger la valeur d'une variable, d'un élément de tableau ou d'une macro en tapant simplement
le nom et en appuyant sur <Entrée>. De même, vous pouvez exécuter un morceau arbitraire de code KiXtart
simplement en le tapant et en appuyant sur <Entrée>.
Quittez KiXtart.
<Échap>, 'q'
Divers…
KiXtart et la console
KiXtart est proposé en deux « saveurs » : la version standard basée sur la console et une version Windows. La version Windows n'affichera
une console que si et quand une sortie est envoyée à l'écran. Si vous le souhaitez, ce comportement peut être remplacé à l'aide de l'option de
ligne de commande /I (Invisible).
Par défaut, la version Windows de KiXtart s'exécute comme un processus asynchrone. Cela signifie que si vous démarrez WKIX32.EXE à partir
d'un fichier batch, le fichier batch n'attendra pas la fermeture de KiXtart et poursuivra le traitement.
Machine
Machine Translated
Google
14 KiXtart2010
Ce comportement peut entraîner des problèmes si KiXtart est utilisé dans le cadre du processus de connexion. Pour éviter ces
problèmes, WKIX32.EXE doit être démarré à partir d'un fichier batch à l'aide de la commande START avec l'option wait, par exemple :
"START /W WKIX32.EXE". En option, vous pouvez également spécifier l'option /B avec la commande START pour empêcher la création
d'une fenêtre supplémentaire.
La version console se comporte exactement comme KiXtart 95 et provoquera automatiquement la création d'une fenêtre de console au
démarrage.
Automatisation COM dans KiXtart 2010

COM Automation est un moyen permettant aux applications (telles que Word et Excel) d'exposer des fonctionnalités à d'autres
applications, notamment des langages de script tels que KiXtart. Cela fournit un moyen simple d'accéder aux propriétés et d'appeler des
méthodes d'autres applications à partir d'un script.
Remarque : la nouvelle prise en charge de l'automatisation COM dans KiXtart 2010 remplace les fonctions OLE des versions précédentes de KiXtart.
Création d'une référence à un objet COM

Une référence à un objet COM peut être créée en attribuant la valeur de retour de la fonction CreateObject ou GetObject à une variable :
$Objet = CreateObject("WScript.Shell")
$ExcelSheet = CreateObject("Excel.Sheet")
$Root = GetObject("LDAP://RootDse")
Libérer un objet
Les références d'objet sont automatiquement libérées si et quand une variable devient hors de portée. Pour libérer explicitement une
référence d'objet, attribuez simplement la valeur 0 (zéro) à la variable contenant le handle de l'objet :
$Objet = 0
Utiliser les propriétés et les méthodes d'un objet

Vous pouvez utiliser la syntaxe object.property pour définir et renvoyer les valeurs de propriété d'un objet ou la méthode object.method
syntaxe pour utiliser les méthodes sur l'objet. Par exemple, vous pouvez définir la propriété Caption de l'objet Application comme suit :
$xlApp = CreateObject("Excel.Application")
$xlApp.Caption = "MonPremierObjet"
Vous pouvez appeler la méthode Quit de l’objet Application Microsoft Excel comme ceci :
$xlApp.Quitter
En général, c'est une bonne idée d'être aussi précis que possible lorsque vous faites référence à des méthodes ou des propriétés d'objets
définies par d'autres applications ou projets.
Machine Translated
KiXtart2010 15
Propriétés par défaut
Certains objets prennent en charge une propriété ou une méthode par défaut. KiXtart fournit une prise en charge limitée pour la lecture des
propriétés par défaut dans les expressions de chaîne ou numériques. Les propriétés par défaut ne sont pas prises en charge lors de
l'attribution d'une référence d'objet à une variable. KiXtart ne prend pas non plus en charge la définition de la valeur des propriétés par défaut.
Exemple 1 : accès à une propriété par défaut dans une expression :
$XL = CréerObjet("EXCEL.Application")
? SousStr($XL,1,10) ; affichera « Microsoft »
Exemple 2 : attribution d'une référence d'objet à une variable :
$XL = CréerObjet("EXCEL.Application")
$AutreRéférence = $XL ; Attribue une référence à $XL
L'utilisation des propriétés par défaut est déconseillée car elles rendent les scripts plus difficiles à lire et sujets aux erreurs.
Exemples d'automatisation COM
Les trois exemples de scripts suivants illustrent quelquesunes des façons dont l'automatisation COM peut être utilisée dans les scripts
KiXtart. Veuillez consulter le Microsoft Developer Network (MSDN) pour plus d'informations sur les nombreuses possibilités d'automatisation
COM.
Exemple 1 : script utilisant l'automatisation COM et l'interface des services Active Directory (ADSI) pour récupérer diverses propriétés
globales d'un serveur LDAP :
$root = GetObject("LDAP://RootDSE")
$root.GetInfo
? " Chemin ADSP : " + $root.ADSPath +

"
? "GUID : $root.GUID +
"
? "Nom: $root.Name +
"
? "Parent: $root.Parent +
"
? "DNC :
$root.defaultNamingContext
Exemple 2 : script utilisant l'automatisation COM et Windows Management Instrumentation (WMI) pour énumérer les disques logiques du
système local :
$Drives = GetObject("winmgmts:").ExecQuery("sélectionnez le nom, le type de lecteur dans Win32_LogicalDisk")
si @erreur <>
0 ? @erreur + autre " / " @erreur
pour chaque $Drive dans $Drives

Machine Translated
16 KiXtart2010
? $Drive.Name
suivant
fin si
Exemple 3 : script montrant comment démarrer Excel et ajouter des données à une feuille de calcul :
$oXL = CreateObject("EXCEL.application")
si @erreur = 0
$oXL.Visible = 1 ; rendre Excel visible à l'utilisateur
$Rc = $oXL.Workbooks.Add; ajouter un nouveau classeur
$array = "Commande #", "Montant", "Taxe"
$oXL.Range("A1:C1").Value = $array;ajouter quelques colonnes
Pour $i = 0 à 19
$oXL.Cells(($i+2),1).Value = "ORD" + ($i + 1000)

$oXL.Cells(($i+2),2).Value = rnd() / 100 Suivant
;Remplissez la dernière colonne avec une formule pour calculer la taxe de

vente. $oXL.Range("C2").Resize(20, 1).Formule = "=B2*0.07"
;Formater la feuille de calcul

$oXL.Range("A1:C1").Font.Bold = 1 $Rc =
$oXL.Range("A1:C1").EntireColumn.AutoFit
$oXL.UserControl = 1
autre
? @erreur + " / " @erreur

fin
Informations sur l'adhésion au groupe.
Introduction.
KiXtart fournit des fonctions pour tester ou énumérer l'appartenance au groupe de l'utilisateur actuel (en particulier : InGroup() et EnumGroup()).
Ces fonctions fonctionnent sur une liste en mémoire de groupes dont l'utilisateur est membre. Cette liste est remplie une fois lors de chaque session
KiXtart (en d'autres termes : une fois à chaque fois que vous exécutez KIX32.EXE).
Les versions précédentes de KiXtart demandaient toujours au serveur de connexion les informations d'appartenance au groupe. Cela a fourni des
informations sur les groupes locaux et globaux dans le domaine de connexion. KiXtart récupère les informations d'appartenance au
groupe à l'aide du jeton de sécurité de l'utilisateur actuel. L'avantage de la nouvelle méthode est que KiXtart peut désormais prendre en charge les
groupes universels ainsi que les groupes globaux imbriqués.
Machine
Machine Translated
Google
KiXtart2010 17
Étant donné qu'un jeton de sécurité est créé lors de la connexion d'un utilisateur et ne change pas pendant que cet utilisateur est connecté, les modifications apportées à
l'appartenance au groupe de l'utilisateur ne sont pas visibles par KiXtart jusqu'à la prochaine connexion de l'utilisateur.
Cache d’informations sur l’appartenance au groupe.
Comme les deux méthodes de récupération de l'appartenance au groupe sont relativement coûteuses en termes de trafic réseau et de temps de traitement, la dernière
mise à jour de KiXtart met en cache les informations d'appartenance au groupe dans le registre. Cela signifie qu'une fois le cache rempli, les exécutions ultérieures de
KIX32.EXE nécessiteront beaucoup moins de temps pour récupérer les informations d'appartenance au groupe.
Le cache d'appartenance au groupe est stocké dans la ruche de registre de l'utilisateur actuel et contient des mappages d'identifiant de sécurité et de nom
de groupe. Les modifications apportées à l'appartenance à un groupe d'un utilisateur sont automatiquement gérées par KiXtart lors de la prochaine connexion.
Si un groupe existant est renommé, cette modification ne sera visible par KiXtart qu'à la prochaine actualisation du cache de jetons.
Le cache est automatiquement actualisé tous les 30 jours.
Un rafraîchissement du cache peut également être forcé à l'aide de la nouvelle option de ligne de commande '/f' :
KIX32 <votrescript> /f
Vous pouvez éventuellement inclure une date indiquant l'âge du cache pour qu'il soit actualisé :
KIX32 <votrescript> /f:2010/12/31
Règles de syntaxe générales
KiXtart est un langage de script au format libre. Le langage n'est pas sensible à la casse. Cela signifie que
IF @PRIV="ADMIN" DISPLAY "ADMIN.TXT" ELSE DISPLAY "USER.TXT" ENDIF
est équivalent à
Si @PRIV = "ADMIN"
Afficher « ADMIN.TXT »
Autre
Afficher « USER.TXT »
Fin si
Lorsque vous utilisez KiXtart, notez les règles suivantes :
• Les chaînes peuvent contenir n'importe quel caractère, à l'exception des caractères \0 (NULL) et \x1a (fin de fichier).
• Les commandes de script doivent être séparées par des espaces, c'estàdire par toute combinaison d'espaces, de tabulations ou de
caractères de nouvelle ligne.
Machine Translated
18 KiXtart2010
• Les chaînes doivent être placées entre guillemets. Par exemple:
« Une chaîne avec un tiret () dedans. » ; Chaîne avec un tiret () dedans.
Bloquer les commentaires
Un « commentaire » est une séquence de caractères commençant par une combinaison barre oblique/astérisque (/*) qui est traitée comme un seul
caractère d'espacement par KiXtart et est autrement ignorée. Un commentaire peut inclure n'importe quelle combinaison de caractères du jeu de caractères
représentables, y compris les caractères de nouvelle ligne, mais à l'exclusion du délimiteur « commentaire de fin » (*/). Les commentaires peuvent occuper
plusieurs lignes mais ne peuvent pas être imbriqués.
Les commentaires peuvent apparaître partout où un espace blanc est autorisé. Le compilateur ignore les caractères du commentaire.
Utilisez des commentaires pour documenter votre code. Cet exemple est un commentaire accepté par le compilateur :
/* Les commentaires peuvent contenir des motsclés tels que

pendant et pendant sans générer d’erreurs. */
Les commentaires peuvent apparaître sur la même ligne qu'une instruction de code :
? "Bonjour" /* Les commentaires peuvent aller ici */
Variables de programme dynamiques
Introduction
Dans KiXtart, les variables sont utilisées pour stocker temporairement des valeurs lors de l'exécution d'un script. Les variables ont un nom (le mot que vous
utilisez pour désigner la valeur que contient la variable), un type (qui détermine le type de données que la variable peut stocker) et une portée (qui
détermine où dans le script vous pouvez référencer la variable). Vous pouvez considérer une variable comme un espace réservé en mémoire
pour une valeur inconnue.
Stockage des données dans des variables
Les variables peuvent se voir attribuer une valeur particulière à l'aide d'une instruction d'affectation :
$Variable = 10
ou en utilisant une instruction GET ou GETS :
OBTENIR $Variable
Facultativement, des variables peuvent être créées et attribuées à une valeur sur la ligne de commande avec laquelle KiXtart est démarré. Pour ce
faire, tapez le nom de la variable suivi d'un signe égal (=) et de la valeur que doit avoir la variable. Par exemple:
Démo KIX32.kix $Key=Valeur

Machine
Machine Translated
Google
KiXtart2010 19
Sur la ligne de commande, n'incluez pas d'espaces entre le signe égal (=) et la valeur. Si vous souhaitez spécifier une valeur contenant des espaces, placezla
entre guillemets (par exemple, KIX32 Demo.kix $Key="Bonjour").
Déclaration de variables
Déclarer une variable, c'est en informer le programme à l'avance. Vous déclarez une variable avec l'instruction Dim ou Global, en fournissant un nom
pour la variable :
nom de la variable DIM
Les variables déclarées avec l'instruction Dim n'existent que tant que le segment de script dans lequel l'instruction Dim a été utilisée est en cours
d'exécution. Une fois le segment de script terminé, la variable et sa valeur disparaissent.
Les variables déclarées avec l'instruction Global existent pendant toute la session KiXtart.
Un nom de variable : •
Ne peut pas contenir de caractères d'opérateur (+,,*,/,&,<,>,=)
• Ne peut pas contenir de point
• Doit être unique dans la même portée, qui est la plage à partir de laquelle la variable peut être référencée dans un script, ou
segment de script.
Vous pouvez utiliser le même nom pour des variables dans différentes portées, et si vous le faites, vous ne pourrez référencer la variable que dans la
portée actuelle. Veuillez consulter l'exemple cidessous pour plus de détails :
Var$ = 10
SI InGroup( "Administrateurs")
DIM $Var ; variable locale du même nom
Var $ = 20
? $Var ; cela affichera '20'
FIN SI
? $Var ; cela affichera '10'
Déclaration implicite
Par défaut, les variables n'ont pas besoin d'être déclarées avant de pouvoir être utilisées. Vous pouvez les déclarer implicitement simplement en leur
attribuant une valeur. Notez que toutes les variables déclarées de cette manière ont une portée globale (voir cidessous pour plus de détails sur la portée).
Facultativement, la déclaration implicite peut être désactivée à l'aide de l'option Explicit (voir SetOption pour plus de détails). Si la déclaration implicite est désactivée,
toutes les variables doivent être explicitement déclarées avant de pouvoir être utilisées.
Machine
Machine Translated
Google
20 KiXtart2010
Portée des variables
Selon comment et où elles sont déclarées, les variables peuvent avoir une portée locale ou globale. Les variables avec une portée globale sont visibles n'importe
où dans n'importe quel script pendant toute la session KiXtart. Les variables avec une portée locale ne sont visibles que par le script ou le segment de
script dans lequel elles ont été créées.
Exemples:
En supposant qu'il s'agisse de la première référence à '$GlobalVariable', cette variable

$VariableGlobale = 10
est implicitement déclarée et deviendra une variable globale,
visible partout dans chaque script lors de cette session KiXtart.
DIM $LocalVariable
Cette variable deviendra une variable locale et sera visible uniquement dans le script en
$VariableLocale = 10 cours.
SI $X = 1
DIM $LocalVariable
Dans cet exemple, $LocalVariable ne sera visible qu'à l'intérieur de l'instruction IF.
$VariableLocale = 10
FIN SI
Démo GOSUB
SORTIE 1
: Démo
Dans cet exemple, $LocalVariable ne sera visible qu'à l'intérieur du sousprogramme 'Demo'.
DIM $LocalVariable
$VariableLocale = 10
RETOUR
Types de variables
Dans KiXtart, les variables sont toujours d'un type de données fondamental : Variant. L'implémentation actuelle de KiXtart utilise trois types de
variantes : les entiers longs, les doubles (nombres à virgule flottante de 8 octets) et les chaînes. Une variante de type chaîne peut contenir jusqu'à 32 000
caractères. Les variables entières peuvent contenir n'importe quelle valeur comprise entre 2 147 483 648 et 2 147 483 647.
Le type d'une variable est automatiquement remplacé par le résultat de l'expression qui lui est affectée. Cela signifie que si vous affectez une chaîne à
une variable contenant un entier, le type de la variable est modifié en chaîne.
Machine
Machine Translated
Google
KiXtart2010 21
Il n'y a pas de limite au nombre de variables pouvant être définies, autre que la quantité de mémoire disponible pour KiXtart.
Notez que KiXtart peut gérer d'autres types de variantes, telles que les booléens, les octets, etc. KiXtart luimême ne
crée pas ces types, mais ils peuvent être renvoyés par d'autres programmes via l'automatisation COM. Si l’un de ces
types de variantes est utilisé dans une expression, il sera converti dans le type approprié avant que l’expression ne
soit évaluée.
Tableaux
KiXtart prend en charge les tableaux comportant jusqu'à 60 dimensions. Les tableaux permettent de faire référence à une série
de variables portant le même nom et d'utiliser un nombre (un index) pour les distinguer. Cela vous aide à créer un code plus petit
et plus simple dans de nombreuses situations, car vous pouvez configurer des boucles qui traitent efficacement n'importe quel
nombre de cas en utilisant le numéro d'index. Les tableaux ont des limites supérieure et inférieure, et les éléments du tableau
sont contigus à l’intérieur de ces limites. Étant donné que KiXtart alloue de l'espace pour chaque numéro d'index, évitez de déclarer
un tableau plus grand que nécessaire.
Lorsque vous déclarez un tableau, faites suivre le nom du tableau de la limite supérieure entre crochets. La limite
supérieure ne peut excéder 2 147 483 647.
Les tableaux peuvent être déclarés avec zéro élément :
Exemples:
Atténuer les compteurs $[14] ; déclaration explicite

Dim $Sommes[20,3] ; déclaration explicite
$NouveauArray = 10,20,30 ; déclaration implicite
$Tableau = "A1", "B2", "C3" ; déclaration implicite
Dim $MyArray[]
La première déclaration crée un tableau de 15 éléments, avec des numéros d'index allant de 0 à 14. La seconde crée un tableau
bidimensionnel de 21 x 4 éléments. Les troisième et quatrième déclarations créent des tableaux de 3 éléments, avec des numéros d'index
allant de 0 à 2. La cinquième déclaration crée un tableau de zéro élément.
Les tableaux ont toujours une variante de type.
Contrairement aux variables normales, les tableaux ne peuvent pas être utilisés dans des chaînes et ne peuvent pas se voir attribuer de valeur sur la
ligne de commande.
Phrases
KiXtart prend en charge trois types d'expressions : chaîne, entier et double.

Une expression de chaîne peut être constituée de n'importe quelle combinaison des éléments suivants :
• Littéraux (une séquence de caractères entourée de guillemets)
• Fonctions qui renvoient une chaîne

Machine
Machine Translated
Google
22 KiXtart2010
• Références d'objet
• Signes plus (+), qui indiquent des sousexpressions concaténées
Les expressions entières et doubles peuvent consister en n’importe quelle combinaison de :
• Sousexpressions
• Valeurs numériques (en notation décimale, hexadécimale ou à virgule flottante, voir cidessous pour plus de détails)
• Fonctions qui renvoient une valeur numérique
• Références d'objet
• Opérateurs numériques (+, –, *, /, mod, &, |)
Notation décimale:
[|+]<chiffres>
Notation hexadécimale :
[|+]<&chiffres>
Notation à virgule flottante : [|

+]<chiffres.>[chiffres][e<exposant>]
KiXtart prend en charge les opérateurs numériques suivants :
+ Utilisé pour additionner deux nombres.
Utilisé pour trouver la différence entre deux nombres ou pour indiquer le
valeur négative d'une expression numérique.

*
Utilisé pour multiplier deux nombres.
/ Utilisé pour diviser deux nombres et renvoyer un résultat entier.
mod Utilisé pour diviser deux nombres et renvoyer uniquement le reste.
& Effectue une opération mathématique ET au niveau du bit sur deux nombres.
| Effectue une opération OU mathématique au niveau du bit sur deux nombres.

^
Effectue une opération XOR mathématique au niveau du bit sur deux nombres.
~
Effectue une opération de négation mathématique au niveau du bit sur un nombre.
Pour spécifier un nombre en notation hexadécimale, ajoutezle au début d'une esperluette (« & »).
Les expressions de chaîne et numériques peuvent contenir les opérateurs conditionnels et logiques suivants :
• < moins de
• > supérieur à
• = égal (insensible à la casse)
• <> différent
• <= inférieur ou égal

Machine Translated
KiXtart2010 23
• >= supérieur ou égal
• == égal (sensible à la casse)
• Pas
• Et
• Or
Une expression de chaîne peut contenir jusqu'à 32 000 caractères. Toute macro ou référence à des chaînes d'environnement dans une chaîne (par exemple : "Chaîne avec le
macro @USERID dedans.") sont résolus avant que la chaîne ne soit évaluée.
Par défaut, les références aux variables à l'intérieur des chaînes (par exemple : "Chaîne contenant un $Var.") sont également résolues avant l'affichage de la chaîne. Les seules
exceptions à cette règle sont les tableaux et les références d'objets, qui ne peuvent pas être utilisés dans des chaînes. Pour utiliser des tableaux ou des références d'objet en combinaison
avec des chaînes, vous devez utiliser la concaténation. Notez que vous pouvez désactiver la résolution de variables ou de macros à l'intérieur de chaînes en utilisant l'option
Options NoVarsInStrings ou NoMacrosInStrings (voir SetOption pour plus de détails).
Les caractères @, %, ou $ sont normalement utilisés pour indiquer des macros, des chaînes d'environnement ou des variables. Si vous souhaitez utiliser ces caractères dans une chaîne,
utilisez @@, %% ou $$.
Les exemples suivants montrent l'utilisation correcte des expressions dans KiXtart :
$X = 1 + "20" ; Type $X = entier / valeur = 21.
$X = &10 + &A ; Type $X = entier / valeur = &1A (26).
$X = "1" + "20" ; Type $X = chaîne / valeur = '120'.
$X = @USERID + "1" ; Type $X = chaîne / valeur = 'USER1'.
"
"Heure actuelle = + @heure ; imprime : "Heure actuelle = 12:34:00"
"Utilisez @@time pour imprimer l'heure" ; prints: "Utilisez @time pour imprimer l'heure"
$Y = "Et voici comment accéder aux variables d'environnement : %USERNAME%..."
SI @Day='Dimanche' ET @USERID = 'RuudV'
$X = (@MONTHNO=3 AND @MDAYNO>=20) OU @MONTHNO=4
SI @WKSTA="VLEERBEER" OU @WKSTA="PALOMINE"
$X = ($ (@YDAYNO + 7) / 7) + 1
; Utilisation à l'ancienne de variables à l'intérieur d'une chaîne :
"Utilisation d'une variable $Var à l'intérieur d'une chaîne."
Nouveau style préféré pour utiliser des variables en combinaison avec des chaînes :
"Utilisation d'une variable" + $Var + "à l'intérieur d'une chaîne."
Machine Translated
24 KiXtart2010
Les chaînes du script sont affichées à l'écran dans la taille de caractère actuelle à partir de la position actuelle du curseur. Pour plus d’informations sur la
taille des caractères, consultez les commandes BIG et SMALL.
Une chaîne peut être entourée de guillemets simples ou doubles. Pour spécifier des guillemets dans une chaîne, utilisez la fonction CHR ou placez la
chaîne entière entre guillemets du type opposé. Autrement dit, si vous souhaitez inclure des guillemets simples dans une chaîne, placez la
chaîne entre guillemets doubles, et le vice
versa.
Les exemples suivants montrent l'utilisation correcte des expressions de chaîne dans KiXtart :
Codé Sortir
Salut Ruudv
"Salut" + @userid
'Guillemet double dans une chaîne : (")' Guillemet double dans une chaîne : (")
"Guillemet simple dans une chaîne : (')" Guillemet simple dans une chaîne : (')
KiXtart détermine le type de l'expression à partir du premier élément de l'expression.
Priorité des opérateurs
Lorsque plusieurs opérations se produisent dans une expression, KiXtart évalue et résout chaque partie de l'expression dans un ordre
prédéterminé. Cet ordre prédéterminé est appelé priorité des opérateurs.
Les parenthèses peuvent être utilisées pour remplacer l'ordre de priorité et forcer certaines parties d'une expression à être évaluées avant d'autres
parties. Les opérations entre parenthèses sont toujours effectuées avant celles en dehors des parenthèses. Entre parenthèses, la priorité des
opérateurs standard est conservée. La priorité des opérateurs affecte le regroupement et l'évaluation des opérandes dans les expressions. Les
expressions avec des opérateurs de priorité plus élevée sont évaluées en premier.
Le tableau suivant résume la priorité des opérateurs pris en charge, en les répertoriant par ordre de priorité, du plus élevé au plus bas. Lorsque
plusieurs opérateurs apparaissent ensemble, ils ont la même priorité et sont évalués de gauche à droite.
Opérateur[ ] Type d'opération

(). Expression
+ ~ PAS
Unaire
*/mod
^ Multiplicatif
+ Ajout
< > <= >= Relationnel
= ==
Égalité
ET OU
ET logique, OU logique
Machine
Machine Translated
Google
KiXtart2010 25
Référence des commandes KiXtart
KiXtart prend en charge les commandes décrites dans les sections suivantes.
Dans cette documentation, les crochets ([ ]) indiquent les arguments facultatifs et les crochets angulaires (< >) indiquent les
arguments obligatoires.
Action Définit une étiquette dans le fichier de script vers laquelle vous pouvez transférer le
contrôle. :étiquette
Syntaxe
commentaires Les étiquettes doivent être uniques dans un script ou une fonction définie par l'utilisateur et ne peuvent pas
contenir de caractères d'espacement. Les étiquettes peuvent être définies à l'intérieur de segments de script (par
exemple à l'intérieur d'un segment WHILE – LOOP), mais vous ne pouvez pas accéder à une telle étiquette depuis
l'extérieur du segment.
De plus, les étiquettes dans les fichiers INCLUDE ne sont autorisées que dans les fonctions définies par l'utilisateur.
Action Indiquez comment. Les caractères suivants sur la ligne de script sont ignorés.
Syntaxe ;
Voir également
Bloquer les commentaires.
Action Indiquez une nouvelle ligne. Cela déplace la position du curseur au début de la ligne suivante. ?
Syntaxe
BIP
Action Jouez le son par défaut.

BIP
Syntaxe
Machine
Machine Translated
Google
26 KiXtart2010
GRAND
Action
Change le mode caractère en gros caractères.
GRAND
Syntaxe
commentaires Lorsque BIG est utilisé, la sortie d'écran suivante est de 8 caractères de large et 8 caractères de haut. Utilisez SMALL
pour réinitialiser le mode caractère à la normale.
BIG est ignoré lorsque la sortie d'écran est redirigée vers un fichier.
CASSER
Action
Active (BREAK ON) ou désactive (BREAK OFF) les touches CTRL+C/BREAK et la commande Fermer. Cela permet
effectivement de contrôler si un script exécuté par KiXtart peut être interrompu ou non.
Syntaxe PAUSE <ON | DÉSACTIVÉ>

commentaires
Par défaut, pour empêcher les utilisateurs d'interrompre un script par inadvertance, KiXtart désactive
automatiquement les touches CTRL+C/BREAK et supprime la commande Fermer dans le menu Système de la fenêtre
d'invite de commande actuelle.
Dans un environnement multitâche tel que Windows NT, les utilisateurs ne peuvent pas être totalement empêchés
d'interrompre un programme. (Les programmes peuvent être arrêtés en utilisant la liste des tâches, par exemple.)
Comme protection supplémentaire, lorsque BREAK est désactivé (valeur par défaut), KiXtart installe également un
gestionnaire d'événements spécial pour la console actuelle. L'effet de ce gestionnaire est que chaque fois qu'un utilisateur
termine de force KiXtart, il est automatiquement déconnecté. Cela signifie également que vous devez être prudent
lorsque vous testez des scripts.
APPEL
Action Exécute un script KiXtart distinct.
Syntaxe APPELER "nom du script"

commentaires Lorsque le script appelé se termine ou lorsqu'une instruction RETURN est rencontrée, l'exécution du script
continue à l'instruction qui suit l'instruction CALL dans le script appelant.
Théoriquement, il n’y a pas de limite au nombre de scripts pouvant être imbriqués. Évidemment, la limite pratique du
nombre de scripts que vous pouvez appeler est déterminée par la quantité de mémoire disponible au moment de
l'exécution de KiXtart, la taille des scripts, le nombre de variables définies, etc.
Notez que CALL ne peut pas être utilisé pour exécuter des fichiers tokenisés qui ont été protégés par un mot de
passe.
Machine Translated
KiXtart2010 27
CD
Action
Remplace le répertoire de travail actuel par le répertoire spécifié.
Syntaxe CDROM d'annuaire
commentaires
Vérifiez la valeur de @ERROR pour voir si le CD a réussi.
CLS
Action Efface l'écran et déplace le curseur à la position 0,0.

CLS
Syntaxe
commentaires
La commande CLS est ignorée si toutes les sorties ont été redirigées vers un fichier à l'aide de la fonction
REDIRECTOUTPUT.
COULEUR
Action
Définit l'attribut de couleur à utiliser dans les instructions d'affichage suivantes.
Syntaxe COULEUR Xx/Aa
Paramètres X
Couleur de premier plan
X
Indication d'intensité en option
Oui
Couleur de l'arrière plan
oui Indication de clignotement en option
Codes couleurs :
Personnage
Faible intensité Haute intensité
PAS Noir
Gris foncé
B Bleu foncé
Bleu clair
g
Vert foncé Vert clair
Bleu foncé Cyan clair
CONTRE
R. Rouge foncé
Rouge clair
M Rose
Magenta
Oui Brun Jaune
W Blanc
Gris clair
commentaires
Si la couleur de premier plan est suivie d'un signe plus (+), la couleur est affichée avec une intensité élevée.
La spécification d'un signe plus (+) avec la couleur d'arrièreplan fait clignoter la couleur.
Machine Translated
28 KiXtart2010
Exemples COULEUR avec+/b

Texte blanc brillant sur fond bleu
COULEUR g/r Texte vert sur fond rouge
$AvantPlan = "y+"
$ArrièreGround = "n"
COULEUR $avantplan/$arrièreplan
Texte jaune vif sur fond noir
$NouvelleCouleur = "b+/g"
COULEUR $NouvelleCouleur
Texte bleu vif sur fond vert
BISCUIT1
Action
Pris en charge uniquement pour la compatibilité ascendante.
Syntaxe BISCUIT1
COPIE
Action
Copie un ou plusieurs fichiers ou répertoires.
Syntaxe COPIER "source" "destination" [/ h] [/s]
Si la source ou la destination spécifie un répertoire, assurezvous d'ajouter une barre oblique inverse à
la fin.
/contre
Continuez l'opération, même si des erreurs surviennent.
/h
Copie également les fichiers cachés et système.
/r
Écrasez les fichiers en lecture seule.
/s
Copie les répertoires et sousrépertoires, y
compris les vides.
commentaires
Les caractères génériques sont pris en charge.
Si un fichier existe déjà à la destination, il est écrasé sans avertissement.
Exemples ; Les exemples suivants copient tous les fichiers de MyDir vers
NewDir COPY "S:\MyDir\*.*" "S:\NewDir\*.*"
COPIER "S:\MonRep\." "S:\NouveauRép\."
COPIER "S:\MonRep\" "S:\NouveauRep\"
; Si la cible (répertoire) n'existe pas, et la spécification cible ; n'a pas de barre oblique inverse à la fin, COPY échouera
avec ; code d'erreur 3 ("chemin introuvable")
Machine Translated
KiXtart2010 29
COPIER "S:\MonRep\" "S:\NouveauRep" ; échoue si NewDir n'existe pas
; Cette commande copiera tous les fichiers qui correspondent à la spécification générique
; et changez leur extension en '.bak'
COPIER "MonRep\fichier*.txt" "MonRep\fichier*.bak"
DÉBOGUER
Action
Active ou désactive le mode débogage au moment de l'exécution.
En mode débogage, la ligne supérieure de l'écran est utilisée pour afficher la ligne actuelle dans le script commençant à l'instruction actuelle. En
option, la deuxième ligne de l'écran est utilisée pour afficher la valeur d'une variable ou d'une macro spécifique.
Les clés suivantes sont disponibles pour contrôler l'exécution du script en mode débogage :
Clé Action/description
F5
Exécuter (désactive le mode débogage, exécute le reste du script jusqu'à la fin ou
jusqu'à ce qu'une commande DEBUG ON soit rencontrée).
F8, <Espace>, <Entrée> Entrez (exécutez une seule instruction, suivez le fil de discussion dans les
sousprogrammes, les UDF et les scripts secondaires).
F10
Passer audessus (exécuter une seule instruction, s'exécuter, mais ignorer les sous
programmes, les UDF et les scripts secondaires en ce qui concerne le débogueur).
'\' (barre oblique inverse) Vous permet d'interroger la valeur d'une variable, d'un élément de tableau
ou d'une macro en tapant simplement le nom et en appuyant sur
<Entrée>. De même, vous pouvez exécuter un morceau arbitraire de
code KiXtart simplement en le tapant et en appuyant sur <Entrée>.
<Échapper>, 'Q' Terminez l’exécution du script et quittez KiXtart.
Syntaxe DÉBOGAGE « ON » | "DÉSACTIVÉ"
commentaires
DEBUG ON est ignoré si le mode débogage a été désactivé à l'aide de
SetOption( "DisableDebugging", "On").
DE LA
Action Supprime un fichier.
Syntaxe DEL « nom de fichier » [/h] [/s]
/contre
/F
Machine Translated
30 KiXtart2010
/h Supprime également les fichiers cachés et système.
/p Reportez l’action jusqu’au prochain redémarrage du système.
/s Supprimez les fichiers spécifiés de tous

les sousrépertoires.
commentaires DEL n'invite pas l'utilisateur à confirmer la suppression.

SOLEIL
Action Déclarez une ou plusieurs variables locales.
Syntaxe DIM "variable1" [<,>"variablex"]
commentaires Les variables locales sont visibles uniquement dans le script ou le segment de script actuel.
DIM $Variable
Exemples
DIM $Tableau[9] ; Remarque : déclaration d'un tableau de 10 éléments.
SI $X = 1
DIM $Var1, $Var2, $Var3
FIN SI
AFFICHER
Action Affiche le contenu d'un fichier à l'écran, en commençant à la position actuelle du curseur.
AFFICHER « nom de fichier »
Syntaxe
FAIRE JUSQU'À CE QUE
Action Boucle jusqu'à ce qu'une expression devienne vraie.

FAIRE
Syntaxe
déclarations...
JUSQU'À "expression"
commentaires Les boucles DO UNTIL peuvent être imbriquées autant de fois que la mémoire le permet.
Machine Translated
KiXtart2010 31
SORTIE
Action
Quitte le script KiXtart actuel ou, s'il est utilisé au niveau le plus élevé, quitte KiXtart. La sortie peut également être utilisée
pour quitter une UDF.
Syntaxe QUITTER [niveau d'erreur / code de sortie]
commentaires
Si EXIT est suivi d'une expression numérique, alors @ERROR est défini sur la valeur de cette expression et vous
pouvez la vérifier dans le script appelant ou le fichier batch.
FLUSHKB
Action
Vide tous les caractères en attente du tampon du clavier.
FLUSHKB
Syntaxe
POUR CHAQUE
Action
Répète un groupe d'instructions pour chaque élément d'un tableau ou d'une collection.
Syntaxe POUR CHAQUE $élément DANS les

instructions de groupe…
SUIVANT
Les boucles FOR EACH peuvent être imbriquées autant de fois que la mémoire le permet.
Paramètres
Élément
Variable utilisée pour parcourir les éléments de la collection ou du tableau.
Groupe
Nom d'une collection d'objets ou d'un tableau.
commentaires
Le bloc For Each est entré s’il y a au moins un élément dans le groupe. Une fois la boucle entrée, toutes les instructions de
la boucle sont exécutées pour le premier élément du groupe. Tant qu'il y a plus d'éléments dans le groupe, les instructions
de la boucle continuent de s'exécuter pour chaque élément. Lorsqu'il n'y a plus d'éléments dans le groupe, la
boucle est quittée et l'exécution continue avec l'instruction suivant l'instruction Next.
Exemples Atténuer $MyArray[10]
Pour chaque $Element dans $MyArray

? $Élément
Suivant
Machine
Machine Translated
Google
32 KiXtart2010
$Root = GetObject( "LDAP://localhost" )

Pour chaque $Obj dans $Root
? $Obj.nom
Suivant
POUR LA SUITE
Action Répète un groupe d'instructions un nombre de fois spécifié.
Syntaxe FOR $counter = start TO end [STEP step] instructions…
SUIVANT
Les boucles FOR NEXT peuvent être imbriquées autant de fois que la mémoire le permet.
Paramètres
Comptoir
Variable numérique utilisée comme compteur de boucle.

Commencer
Valeur initiale du compteur $.
Fin
Valeur finale du compteur $.
Le
compteur de montant de pas est modifié à chaque fois dans la boucle. Si elle n’est pas spécifiée, l’étape
est par défaut une. L’argument step peut être positif ou négatif. La valeur de l'argument step détermine le
traitement de la boucle comme suit : Valeur
La boucle s'exécute si
Positif ou 0 $compteur <= fin
Négatif $compteur >= fin
commentaires Une fois la boucle démarrée et toutes les instructions de la boucle exécutées, Step est ajouté au compteur. À ce
stade, soit les instructions de la boucle s'exécutent à nouveau (sur la base du même test qui a provoqué l'exécution
initiale de la boucle), soit la boucle est quittée et l'exécution continue avec l'instruction suivant l'instruction Next.
Changer la valeur du compteur à l'intérieur d'une boucle peut rendre plus difficile la lecture et le débogage de
votre code.
Exemple Pour $Count = 0 à 10 Étape 2 ?

Nombre $
Suivant
Machine
Machine Translated
Google
KiXtart2010 33
FONCTION
Action Déclare le nom, les arguments et le code qui forment le corps d'une procédure Function.
Une procédure Function est une procédure distincte qui peut prendre des arguments, exécuter une
série d’instructions et modifier les valeurs de ses arguments. Une procédure Function peut être utilisée sur le
côté droit d’une expression de la même manière que vous utilisez n’importe quelle fonction
intrinsèque, telle que Len ou Asc, lorsque vous souhaitez utiliser la valeur renvoyée par la fonction.
Syntaxe Nom de la fonction [(argument1, argument2, [facultatif]argumentx)]

[déclarations]
[nom = expression]
FinFonction
Paramètres
Nom
Nom de la fonction. Notez que le nom doit être unique et ne peut pas être identique à une étiquette dans
la même portée.
Liste d'arguments
Liste de variables représentant les arguments transmis à la procédure Function lors de son appel.
Plusieurs variables sont séparées par des virgules. Tous les arguments sont passés par valeur. Si
un argument est précédé du mot clé OPTIONAL, l'argument n'est pas obligatoire et tous les
arguments suivants dans la liste doivent également être facultatifs et déclarés à l'aide du mot clé
OPTIONAL.
Déclarations
Tout groupe d'instructions à exécuter dans le corps de la procédure Function.
Expression
Valeur de retour de la fonction.
commentaires Les procédures fonctionnelles ont une portée globale, c'estàdire qu'elles sont visibles par tous les
autres scripts et procédures des scripts. La valeur des variables locales dans une fonction n'est
pas conservée entre les appels à la procédure.
Vous ne pouvez pas définir une procédure Function dans une autre procédure.
L'instruction Return provoque une sortie immédiate d'une procédure Function. L'exécution du programme
se poursuit avec l'instruction qui suit l'instruction qui a appelé le
Procédure de fonction. N'importe quel nombre d'instructions Return peut apparaître n'importe où dans
une procédure Function.
Vous appelez une procédure Function en utilisant le nom de la fonction, suivi de la liste d’arguments entre
parenthèses, dans une expression.
Remarque : Les procédures fonctionnelles peuvent être récursives, c'estàdire qu'elles peuvent s'appeler elles
mêmes pour effectuer une tâche donnée. Cependant, la récursivité peut entraîner un débordement de pile.
Machine Translated
34 KiXtart2010
Pour renvoyer une valeur d'une fonction, attribuez la valeur au nom de la fonction. Un certain nombre de ces affectations
peuvent apparaître n'importe où dans la procédure. Si aucune valeur n'est affectée à name, la procédure renvoie une
valeur vide.
Les variables utilisées dans les procédures Function se répartissent en deux catégories : celles qui sont explicitement
déclarées dans la procédure et celles qui ne le sont pas. Les variables explicitement déclarées dans une
procédure (à l'aide de Dim) sont toujours locales à la procédure. Les variables utilisées mais non explicitement déclarées
dans une procédure sont globales.
Remarque : une procédure peut utiliser une variable qui n'est pas explicitement déclarée dans la procédure, mais un
conflit de nom peut survenir si quelque chose que vous avez défini au niveau du script porte le même nom. Si votre
procédure fait référence à une variable non déclarée qui porte le même nom qu'une autre procédure ou variable, il
est supposé que votre procédure fait référence à ce nom de niveau script.
Exemples "" du serveur)

Fonction ReadNC (Nom
$ReadNC =
$Root = GetObject( "LDAP://" + ServerName + "/rootDSE" )
Si @ERREUR = 0
$ReadNC = $Root.defaultNamingContext
Fin si
FinFonction
OBTENIR
Action
Accepte un seul caractère du clavier et stocke le caractère dans une variable.
OBTENEZ x $
Syntaxe
commentaires
Le caractère est stocké dans la variable de script spécifiée. Si une touche de fonction, telle que F1, est enfoncée, GET
renvoie 0 et @ERROR renvoie le code de la touche de fonction.
OBTIENT
Action
Lit une ligne de caractères du clavier jusqu'à ce que la touche <ENTER> soit enfoncée et stocke le résultat dans une
variable.
Syntaxe GAGNE x $
Machine
Machine TraduitTranslated
par Google by Google
KiXtart2010 35
DANS L'ENSEMBLE
Action
Déclarez une ou plusieurs variables globales.
Syntaxe GLOBAL "variable1" [<,>"variablex"]
commentaires
Les variables globales sont visibles partout dans chaque script pendant la session KiXtart en cours.
GLOBAL $X
Exemples
GLOBAL $X, $Y, $Z
[ALLER]
Action
Modifie le lecteur actuel.
Syntaxe [ALLER] conduire
commentaires
Utilisez GO si vous souhaitez spécifier une variable comme lecteur vers lequel passer.
ALLER A :
Exemples
A:
ALLER 2 $
GOSUB
Action
Provoque la poursuite de l'exécution du script à la première instruction après une étiquette.
GOSUB <étiquette>
Syntaxe
commentaires
L'étiquette peut être une expression.
Lorsqu'une instruction RETURN est rencontrée, l'exécution du script continue à l'instruction qui suit l'instruction
GOSUB.
Notez que vous ne pouvez pas GOSUB entrer ou sortir d'un fichier INCLUDE.
Exemples ? "Cela démontre l'appel d'un sousprogramme"

GOSUB « Démo »
? "Fin de la manifestation..."
SORTIE 1
: Démo
? "Nous sommes dans le sousprogramme maintenant..."
RETOUR
Machine Translated by Google
Machine Traduit par Google
36 KiXtart2010
ALLER À
Action Provoque la poursuite de l'exécution du script à la première instruction après une étiquette.
ALLER À <étiquette>
Syntaxe
commentaires L'étiquette peut être une expression.
Notez que vous ne pouvez pas GOTO dans ou hors d'un fichier INCLUDE.
ALLER À « fin »
Exemples
$string = "fin"
GOTO $chaîne
SI Ailleurs ENDIF
Action
Exécute les instructions de manière conditionnelle.
Syntaxe instruction
d'expression SI1
....
[ELSE
déclaration2
....
]
FIN SI
commentaires
Le corps d'une instruction IF est exécuté de manière sélective en fonction de la valeur de l'expression. Si
l'expression est vraie, alors l'instruction1 est exécutée. Si l'expression est fausse et que la clause ELSE est spécifiée,
alors instruction2 est exécutée.
Les instructions IF peuvent être imbriquées autant de fois que la mémoire le permet.
Si l'expression ne contient aucun opérateur relationnel, la condition est considérée comme vraie si elle est numérique
et si elle est évaluée à une valeur autre que zéro, ou si elle est alphanumérique et si elle est
évaluée à une chaîne contenant au moins un caractère.
Notez que par défaut, toutes les comparaisons de chaînes ne sont pas sensibles à la casse. Ce comportement
peut être modifié à l'aide de la fonction SetOption. Veuillez consulter la description de la fonction SetOption
pour plus de détails.
SI $X ; similaire à SI $X <> 0
Exemples
; faire des choses
FIN SI
""
SI @HOMESHR ; similaire à SI @HOMESHR <>
; faire des choses
FIN SI
Machine
Machine Traduit parTranslated
Google by Google
KiXtart2010 37
SI INGROUP("Administrateurs") ; ; similaire à IF INGROUP("Admins") > 0
faire des choses
FIN SI
IF NOT INGROUP("Administrateurs de domaine"); vrai si l'utilisateur n'est PAS un administrateur de domaine
; faire des choses
FIN SI
SI $X*2 < 10
; faire des choses
FIN SI
SI (($X*2) < 10) OU ($Y + 100) /3 >120
; faire des choses
FIN SI
SI INSTR(%PATH%,"NETLOGON") ET @DOS = "3.51"
; faire des choses
FIN SI
SI (SUBSTR (@WKSTA,11,1)="1" AND @USERID = "PETERV") OU @DOMAIN =

«VleerBière»
; faire des choses
FIN SI
SI @USERID = "RUUDV" OU @USERID = "WIMW"
; faire des choses
FIN SI
SI (INGROUP("Utilisateurs du domaine") OU INGROUP("Utilisateurs"))
; faire des choses
FIN SI
COMPREND
Action
INCLUDE indique à KiXtart de traiter le contenu d'un fichier spécifié comme si ce contenu était apparu dans le script au moment
où INCLUDE apparaît. Vous pouvez organiser le code de script dans des fichiers d'inclusion, puis utiliser INCLUDE pour ajouter ce code à n'importe quel fichier.
scénario.
Les fichiers d'inclusion peuvent être « imbriqués » ; c'estàdire qu'une instruction INCLUDE peut apparaître dans un fichier nommé par un autre INCLUDE
déclaration. L'imbrication des fichiers d'inclusion peut continuer jusqu'à 20 niveaux.
Les fichiers d'inclusion peuvent contenir des fonctions définies par l'utilisateur ainsi que du code de script direct. Notez que le code du script direct (c'estàdire : le code
en dehors des fonctions définies par l'utilisateur) ne peut pas contenir d'étiquettes et que vous ne pouvez pas accéder à un fichier INCLUDE ou en sortir.
Machine
Machine Translated
Google
38 KiXtart2010
INCLUDE est particulièrement utile lors de la prétokenisation de fichiers : les fichiers d'inclusion sont effectivement fusionnés
avec le script contenant les instructions INCLUDE et le résultat final est stocké sous la forme d'un seul fichier prétokenisé.
Syntaxe INCLURE « inclurenomscript »
Includescriptname peut inclure un chemin absolu (« C:\SCRIPTS ») ou un chemin relatif (« ..
\DONNÉES\SCRIPTS »). Si vous spécifiez un chemin relatif, le chemin est calculé à partir du répertoire courant du processus
KiXtart.
commentaires
Notez que les instructions INCLUDE sont traitées pendant la phase de prétraitement de KiXtart, auquel cas les macros, variables
et fonctions ne sont pas encore disponibles. En tant que tel, INCLUDE ne prend en charge qu'une seule chaîne plate et vous ne pouvez
pas utiliser de macros, de variables ou de fonctions dans cette chaîne.
Le code de script dans les fichiers INCLUDE qui ne se trouve pas dans les fonctions définies par l'utilisateur ne peut pas contenir
d'étiquettes et vous ne pouvez pas accéder ou sortir d'un fichier INCLUDE.
MARYLAND
Action
Créer un nouveau dossier. Si nécessaire, crée automatiquement les dossiers intermédiaires manquants.
Syntaxe MD "répertoire"
commentaires
Vérifiez la valeur de @ERROR pour voir si MD a réussi (@ERROR = 0).
SE DÉPLACER
Action Déplace ou renomme des fichiers et des répertoires.
Syntaxe MOVE "source" "destination" [/c] [/h] [/p] [/r] [/s]
Si la source ou la destination spécifie un répertoire, assurezvous d'ajouter une barre oblique inverse à la fin. Si la
destination existe, la source sera déplacée sous la destination. Si la destination n'existe pas, la source sera renommée.
/contre
/h
Déplace/renomme également les fichiers cachés et système.
/p Reportez l’action jusqu’au prochain redémarrage du système.
/r
Machine
KiXtart2010 39
/s Renomme les fichiers spécifiés dans tous

les sousrépertoires.
commentaires
MOVE écrase les fichiers existants sans avertissement.
Exemples ; Si NewDir n'existe pas, cette commande RENOMMERa MyDir en NewDir :

DÉPLACER "S:\MonRep\" "S:\NouveauRep\"
; Si NewDir existe, cette commande déplacera MyDir sous NewDir :

DÉPLACER "S:\MonRep\" "S:\NouveauRep\"
; Cette commande modifiera l'extension de tous les fichiers correspondant au ;
spécification de caractère générique pour '.bak'
DÉPLACER "MonRep\fichier*.txt" "MonRep\fichier*.bak"
MOT DE PASSE
Action
Pas de fonction; pris en charge uniquement pour la compatibilité avec KiXtart 2.3x.
Syntaxe MOT DE PASSE « mot de passe »
JOUER
Action
Lit de la « musique » sur le hautparleur de l'ordinateur, en utilisant le format de fichier SPK décrit cidessous, ou
sur une carte son en lisant un fichier WAV.
Syntaxe LECTURE [FICHIER "chemin\nomfichier.spk"] | "chaîne" | "chemin\nom de fichier.wav"

Il existe quatre formes syntaxiques possibles :
• LIRE LE FICHIER « Jbond.spk »
• JOUER « 0g256t 0g8d247f 4d165f 247f 8d262f 4d165f 262f 8d277f 4d165f »
• LIRE LE FICHIER « Ding.wav »
• JOUER « Chimes.wav »
La chaîne ou le fichier est constitué d'une séquence de commandes indiquant la fréquence et la durée des tonalités à
jouer. Les commandes suivantes sont disponibles :
• F ou f fréquence
Cette commande provoque la production d'une tonalité à la fréquence actuelle. La fréquence actuelle initiale est de
1000 Hz. Pour modifier la valeur, indiquez la fréquence souhaitée suivie immédiatement du caractère f. Par exemple,
pour produire une tonalité à 1 500 Hz, spécifiez 1 500 F.
Machine Translated
40 KiXtart2010
• G ou g écart
Cette commande définit le nombre de ticks de minuterie (1 seconde = 18 ticks) de silence entre les
tonalités individuelles. Le nombre de tics de minuterie entre les tonalités est spécifié sous la forme d'un
nombre immédiatement suivi de G. La valeur initiale est 0.
• D ou d durée
Cette commande définit la durée (en ticks de minuterie) de chaque tonalité. Par exemple, pour que chaque
tonalité dure environ un tiers de seconde, utilisez la commande 6d.
• T ou t tempo
Cette commande met à l'échelle la durée de chaque tonalité. Cela vous permet de modifier globalement
la durée d'une série de tonalités, sans avoir à modifier chacune des commandes de durée
individuelles. Une valeur de tempo de 256 indique un tempo normal. Une valeur de 4df dure :
• 2 ticks de minuterie, lorsque le tempo est réglé sur 128
commentaires KiXtart sélectionne automatiquement l'action appropriée en fonction de l'extension du nom de fichier que vous
fournissez.
Exemple JOUER"0g256t 0g8d247f 4d165f 247f 8d262f 4d165f 262f 8d277f 4d165f
277f 8d262f 4d165f 262f 8d247f 4d165f 247f 8d262f 4d165f
262f 8d277f 4d165f 277f 8d262f"
Cela joue le rôle du thème de James Bond.
QUITTER
Action Quitte KiXtart.
Syntaxe QUITTER [niveau d'erreur / code de sortie]
commentaires Si QUIT est suivi d'une expression numérique, alors la valeur de cette expression est utilisée comme code de sortie
de KiXtart et vous pouvez la vérifier à l'aide d'un fichier batch.
DR
Action Supprime le répertoire spécifié. Remarque : le répertoire doit être vide pour que cette commande réussisse, sauf
si l'option '/s' est utilisée.
/s Supprime le répertoire spécifié et tous les fichiers et sousrépertoires en dessous.
Syntaxe RD "répertoire" [/s]

Machine
Machine Translated
Google
KiXtart2010 41
commentaires
Vérifiez la valeur de @ERROR pour voir si RD a réussi.
REDIM
Action
Déclare les variables de tableau dynamique et alloue ou réaffecte l'espace de stockage au niveau procédural.
Syntaxe REDIM [PRÉSERVÉ] "variable1" [<,> [PRÉSERVÉ] "variablex"]
commentaires
Si le motclé Preserve est spécifié, chaque dimension, à l'exception de celle la plus à droite, doit être la même que celles
du tableau existant. Les valeurs du tableau existant sont copiées dans le nouveau tableau : si le nouveau tableau est plus
petit, les valeurs existantes sont ignorées ; si le nouveau tableau est plus grand, les éléments supplémentaires
seront vides.
Exemples REDIM $MyArray[20]
REDIM PRÉSERVER $Array[9] ; Remarque : préserve le contenu du tableau.
REDIM PRÉSERVER $FirstArray[9] , PRÉSERVER $NextArray[10]
RETOUR
Action
Provoque la poursuite de l'exécution du script à l'instruction suivant la dernière instruction CALL ou GOSUB, et renvoie
également depuis l'intérieur d'une UDF.
RETOUR
Syntaxe
commentaires Si RETURN est spécifié dans le script principal, KiXtart se termine.
COURIR
Action Exécute une commande.
EXÉCUTER la « commande »
Syntaxe
commentaires
La commande peut être n’importe quelle application 16 bits ou 32 bits. Pour exécuter des commandes
d’interpréteur de commandes, spécifiez l’interpréteur de commandes correct dans le cadre de la commande.
RUN n'attend pas la fin du programme. L'exécution du script continue immédiatement. Ce
comportement est différent de la version MSDOS de KiXtart, où la commande RUN termine également le script. Si vous
souhaitez émuler la version MSDOS, vous devez ajouter une commande EXIT après la commande RUN.
EXÉCUTER @LDRIVE + "\UPDATE.EXE"

Exemples
EXÉCUTER "%COMSPEC% /e:1024 /c DIR C:"
Machine
Machine Translated
Google
42 KiXtart2010
SÉLECTIONNER LE CAS…FINSÉLECTIONNER
Action Une instruction SELECT est un moyen efficace d’écrire une série d’instructions IF ELSE.
SÉLECTIONNER
Syntaxe
Expression de CAS
déclaration1
....
[expression CAS
déclaration2
.... ]
FINSÉLECTIONNER
commentaires Une instruction SELECT se compose d'une ou plusieurs conditions (CASE), chacune étant suivie d'une
ou plusieurs instructions qui ne sont exécutées que si la condition est évaluée à TRUE. L'instruction SELECT est
traitée de haut en bas. Si une expression est évaluée à TRUE, les instructions qui la suivent immédiatement
sont exécutées, jusqu'à l'instruction CASE suivante.
Une seule instruction CASE est exécutée, quel que soit le nombre d'instructions évaluées à TRUE.
Si l'expression ne contient aucun opérateur relationnel, la condition est considérée comme vraie si elle est
numérique et si elle est évaluée à une valeur autre que zéro, ou si elle est alphanumérique et
si elle est évaluée à une chaîne contenant au moins un caractère.
Les instructions SELECT peuvent être imbriquées autant de fois que la mémoire le permet.
SÉLECTIONNER
Exemples
CASE InGroup("Administrateurs de domaine") AND @DAY = 1
? "Peu importe…"
CASE InGroup("Utilisateurs Office")

? "Etc…"
? "Etc…"
ENCADRÉ 1
; c'est une bonne façon de fournir un CASE par défaut ; si tous les autres
; Les CASE échouent, celuici sera toujours exécuté
? "Hmm, tu ne fais pas partie d'un de nos groupes ?"

FINSÉLECTIONNER
ENSEMBLE
Action Sous Windows NT/2000/XP, définit les variables d'environnement dans l'environnement de l'utilisateur
actuel (HKEY_CURRENT_USER\Environment).
Syntaxe SET "variable=chaîne"

commentaires Après toute modification de l'environnement, KiXtart informe les programmes en cours d'exécution que
la modification a été effectuée, les invitant à régénérer leur environnement. Programmes prenant en charge
cette fonctionnalité (tels que le Gestionnaire de programmes, le Gestionnaire des tâches et Windows
Machine Translated
KiXtart2010 43
Explorer) mettent à jour leurs environnements lorsqu'ils reçoivent le message WM_SETTINGCHANGE.
L'environnement du processus en cours (KiXtart) n'est pas affecté.
SETL
Action Définit les variables d'environnement dans l'environnement local que vous voyez lorsque vous
démarrez un programme à partir d'un script KiXtart.
Syntaxe SETL "variable=chaîne"

commentaires Cette commande n'affecte pas l'environnement actuel. Si vous démarrez KiXtart à partir d'un fichier de
commandes, les commandes du fichier de commandes exécutées après la fermeture de KiXtart ne voient pas
les modifications apportées par les commandes SET ou SETL. Si vous souhaitez exécuter des fichiers
batch ou des programmes qui dépendent des paramètres définis par KiXtart, démarrezles depuis
KiXtart en utilisant SHELL ou RUN.
SETL définit la valeur de @ERROR.
SETM
Action Sous Windows NT/2000/XP, définit les variables d'environnement dans l'environnement de l'ordinateur
local
(HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment).
Syntaxe SETM "variable=chaîne"

commentaires Sous Windows 2000/XP, après toute modification de l'environnement, KiXtart informe les programmes
en cours d'exécution que la modification a été effectuée, les invitant à régénérer leur environnement.
Les programmes prenant en charge cette fonctionnalité (tels que le Gestionnaire de programmes, le
Gestionnaire des tâches et l'Explorateur Windows) mettent à jour leurs environnements
lorsqu'ils reçoivent le message WM_SETTINGCHANGE.
L'environnement du processus en cours (KiXtart) n'est pas affecté.
RÉGLER LE TEMPS
Action Synchronise l'horloge système de l'ordinateur local avec l'heure d'une heure spécifiée.
source.
RÉGLAGE « source »
Syntaxe
commentaires La source peut être l'une des valeurs suivantes :
Un nom de serveur exprimé en KiXtart se connecte au serveur spécifié pour récupérer le
Machine Translated
44 KiXtart2010
Format UNC temps.
Un nom de domaine
KiXtart parcourt le domaine à la recherche d'un serveur exécutant le service Time
Source.
"*"
KiXtart parcourt le domaine local pour tout serveur exécutant le
service Time Source.
Notez que SETTIME nécessite que l'utilisateur actuel dispose du privilège « Modifier l'heure du système ».
RÉGLER LE TEMPS "*"

Exemples
RÉGLAGE DE L'HEURE « \\MON TEMPS »
RÉGLER « DOMAINE TEMPOREL »
COQUILLE
Action
Charge et exécute un programme.
COQUILLE "commande"
Syntaxe
commentaires
La commande peut être n’importe quelle application 16 bits ou 32 bits. Pour exécuter des commandes d’interpréteur de commandes,
spécifiez l’interpréteur de commandes correct dans le cadre de la commande.
L'exécution du script est arrêtée jusqu'à la fin du programme.
Si le programme que vous souhaitez exécuter doit définir des variables d'environnement (comme c'est le cas avec Smsls.bat, par exemple), vous
devrez peutêtre spécifier un espace d'environnement supplémentaire à l'aide du paramètre /E.
SHELL définit la valeur de @ERROR sur le code de sortie du programme exécuté.
Exemples COQUILLE @LDRIVE + "\UPDATE.EXE"

COQUILLE "%COMSPEC% /e:1024 /c DIR C:"
COQUILLE « SETW USERNAME=@USERID »

"
COQUE "CMD.EXE /C COPIE + @LDRIVE + "\FILE.TXT C:\"
SHELL "%COMSPEC% /C COPIE Z:\FILE.TXT C:\"
COQUILLE "C:\WINNT\SYSTEM32\CMD /E:1024 /C" + @LDRIVE + "\SMSLS.BAT"
DORMIR
Action
Arrête l'exécution du script pendant le nombre de secondes spécifié. Notez que vous pouvez spécifier des fractions de seconde.
SOMMEIL <secondes>
Syntaxe
SOMMEIL 10
Exemples ; mettre le script en pause pendant 10 secondes
SOMMEIL 0,5 ; mettre le script en pause pendant une demiseconde

Machine
Machine Traduit Translated
KiXtart2010 45
PETIT
Action
Change le mode caractère en petits caractères (normaux).
PETIT
Syntaxe
commentaires
Après avoir utilisé SMALL, la sortie d'écran suivante est normale. Pour plus d’informations, voir BIG plus haut dans cette section.
PORTÉ
Action Connectez, déconnectez ou répertoriez les connexions réseau.
Syntaxe LISTE D'UTILISATION [/PERSISTANT]
UTILISER <* | "appareil" | "ressource"> /DELETE [/PERSISTENT]
UTILISER ["device"] <"resource"> [/USER:”user”] [/PASSWORD:”password”]
[/PERSISTANT]
commentaires
Utilisez USE "*" /DELETE pour supprimer toutes les connexions actuelles, à l'exception de celles vers un partage
NETLOGON et celles vers le lecteur ou le partage à partir duquel KiXtart a été démarré.
Si le nom de la ressource, le nom d'utilisateur ou le mot de passe contiennent des caractères non alphanumériques (tels que ou +),
veillez à les mettre entre guillemets.
Vérifiez la valeur de @ERROR pour voir si USE a réussi (une valeur de 0 indique le succès).
La syntaxe
"USE *" permet de rediriger le premier lecteur disponible vers une ressource. Si la redirection réussit, @RESULT
contiendra la lettre de lecteur du lecteur redirigé.
TU VOIS: "\\SERVEUR\PUBLIC" /PERSISTANT

Exemples
UTILISER * / SUPPRIMER
TU VOIS:
"\\SERVEUR\PUBLIC" /user:Yogi /mot de passe:Ours
TU VOIS: "\\SERVEUR\PUBLIC"
UTILISER LPT1 : "\SERVER\LASER" /user:testlan\USER1
UTILISER L : /LED
UTILISER LA LISTE
UTILISER * @HOMESHR ; connecter n'importe quel lecteur au partage personnel de l'utilisateur
SI @ERREUR = 0
"
? "Connecté" + @RESULTAT + en partage de maison… »
FIN SI
Machine
46 KiXtart2010
UTILISER H : @HOMESHR ; se connecter au partage personnel de l'utilisateur
SI @ERREUR = 0
H: ;
CD @HOMEDIR ; changer le répertoire en répertoire personnel de l'utilisateur
FIN SI
PENDANT BOUCLE
Action
Exécute un ensemble d'instructions tant qu'une expression est vraie.
Syntaxe TANDIS que les déclarations

"expression"...
BOUCLE
commentaires
Les boucles WHILE peuvent être imbriquées autant de fois que la mémoire le permet.
Machine Translated
KiXtart2010 47
Référence des fonctions KiXtart
La plupart des fonctions prennent une ou plusieurs expressions de chaîne ou numériques comme paramètres. Les paramètres
de chaîne sont indiqués par des guillemets doubles autour du nom du paramètre. Certaines fonctions autorisent des paramètres
facultatifs. Si vous omettez ces paramètres, la fonction utilise à la place une valeur par défaut.
Valeurs de retour
La plupart des fonctions renvoient soit une chaîne, soit une valeur numérique et peuvent donc être utilisées partout où une expression
est attendue. La plupart des fonctions définissent également les valeurs de @ERROR et @SERROR, ce qui vous permet de vérifier si
la fonction a réussi.
Fonctions de registre
Toutes les fonctions de registre utilisent le format suivant pour spécifier les sousclés de registre :
[\\remote_computer_name\][Key\]Sousclé
Remote_computer_name peut être n’importe quel nom d’ordinateur valide au format UNC (précédé de deux barres obliques inverses). Si
vous ne spécifiez pas de nom_ordinateur_distant, le programme utilise par défaut le registre local.
La clé peut être l’une des arborescences principales du registre :
HKEY_LOCAL_MACHINE (HKLM)
HKEY_USERS (HKU)
HKEY_CLASSES_ROOT (HKCR)
HKEY_CURRENT_USER (HKCU)
HKEY_CURRENT_CONFIG (HKCC)
Si vous ne spécifiez pas de clé racine, KiXtart utilisera HKEY_CURRENT_USER par défaut.
La sousclé peut être n’importe quelle sousclé de registre valide. Si le nom d'une sousclé contient des espaces, placez
l'expression entière entre guillemets.
Les exemples suivants montrent la syntaxe correcte des clés :
"\\VLEERBEER\HKEY_LOCAL_MACHINE\CONTROL"
"HKEY_CURRENT_USER\Groupes de programmes\Jeux"
"Panneau de configuration\International\Ordre de tri"
"HKCU\Groupes de programmes\Jeux"
Lorsque vous accédez à un registre distant, vous ne pouvez spécifier que HKEY_LOCAL_MACHINE ou HKEY_USERS.
KiXtart ne demande pas de confirmation lorsque les valeurs de registre sont écrasées ou lorsque les sousclés sont supprimées.
Soyez toujours très prudent lorsque vous modifiez le registre et sauvegardez de préférence votre système avant de modifier les
valeurs du registre.
Machine
Machine Translated
Google
48 KiXtart2010
abdos
Action Renvoie la valeur absolue d'un nombre.
Syntaxe ABS (expression)

Paramètre
Expression
Toute expression numérique valide.
Retour Valeur absolue d'un nombre.
ADDKEY
Action Ajoute la sousclé spécifiée au registre.
Syntaxe ADDKEY ("sousclé")

Paramètre
Sousclé
Une chaîne qui spécifie le nom de la sousclé que vous souhaitez ajouter au registre.
Retour 0
Sousclé ajoutée
Code d'erreur La fonction a échoué
Exemple $ReturnCode = AddKey("HKEY_CURRENT_USER\EZReg")

Si $ReturnCode = 0
? "Clé ajoutée...."
Fin si
ADDPRIMTERCONNEXION
Action Ajoute une connexion à l'imprimante spécifiée pour l'utilisateur actuel.
Syntaxe ADDPRINTERCONNECTION (« partage d'imprimante »)
Paramètres Partager l'impression
Le nom (de partage) de l’imprimante à laquelle se connecter.
commentaires Cette fonction ne peut être utilisée que pour se connecter à des imprimantes sur un serveur
exécutant Windows 2000 ou supérieur.
Lors de la connexion à une imprimante, le système peut copier les fichiers du pilote d'imprimante
sur l'ordinateur local. Si l'utilisateur n'est pas autorisé à copier des fichiers à l'emplacement
approprié, ADDPRINTERCONNECTION échoue et @ERROR renvoie
ERROR_ACCESS_DENIED.
Machine
Machine Translated
Google
KiXtart2010 49
Retour 0 Connexion imprimante établie
Exemple Si ADDPRINTERCONNECTION ("\\vleerbeer\hp laserjet 4") = 0

? « Connexion d'imprimante ajoutée. »
Fin si
AJOUTERUN GROUPEPROGRAMME
Action
Instructions au gestionnaire de programme pour créer un nouveau groupe de programmes.
Syntaxe ADDPROGRAMGROUP ("nom du groupe", indicateur de groupe commun)
Paramètres Nom de groupe
Identifiez la fenêtre de groupe à ajouter.
Indicateur de groupe
commun Paramètre numérique facultatif. L'indicateur de groupe commun peut avoir les valeurs suivantes :
0
Créez un groupe personnel.
1
Créez un groupe commun. L'utilisateur actuel doit disposer de privilèges administratifs, sinon la
fonction échoue.
Retour 0
Groupe de programmes ajouté
Exemple Si AddProgramGroup("NouveauGroupe", 0) = 0
? "NewGroup a créé..."
Fin si
AJOUTER UN ARTICLE DE PROGRAMME
Action
Instructions au gestionnaire de programme pour ajouter une icône au groupe de programmes actif.
Syntaxe ADDPROGRAMITEM ("ligne de commande", "nom", "chemin de l'icône", index de l'icône, "répertoire par défaut", minimiser,
remplacer, exécuter dans son propre espace)
Paramètres Ligne de commande
Spécifie la ligne de commande requise pour exécuter l'application. Ce paramètre est une chaîne contenant le nom du
fichier exécutable de l'application. Il peut également inclure le chemin de l'application et tous les paramètres requis.
Nom
Spécifie le titre affiché sous l'icône dans la fenêtre de groupe.

Machine
50 KiXtart2010
Chemin de l'icône
Identifie le nom de fichier de l'icône à afficher dans la fenêtre de groupe. Cette chaîne identifie un fichier exécutable
Windows ou un fichier icône. Si aucun chemin d'accès à l'icône n'est spécifié, Program Manager utilise la première
icône du fichier spécifié par la ligne de commande si ce fichier est un fichier exécutable.
Si la ligne de commande spécifie un fichier associé à un programme, Program Manager utilise la première icône
fournie dans le fichier exécutable de ce programme.
Les informations sur l'association sont obtenues à partir du registre. Si la ligne de commande ne spécifie ni un fichier
exécutable ni un programme associé, Program Manager utilise une icône par défaut.
Icône d'index
Ce paramètre est un entier qui spécifie l'index de l'icône dans le fichier identifié par le paramètre de chemin d'icône. Le
Gestionnaire de programmes comprend cinq icônes par défaut qui peuvent être utilisées pour les programmes non
écrits pour Windows.
Répertoire par défaut

Spécifie le nom du répertoire par défaut (ou de travail). Ce paramètre est une chaîne.
Minimiser
Paramètre numérique facultatif. Spécifie si une fenêtre d'application est réduite lors de son premier
affichage. Les valeurs possibles pour ce paramètre sont :
0
Paramètre système par défaut
1 Minimiser
Remplacer
Paramètre numérique facultatif. Spécifie si ADDPROGRAMITEM remplace un élément de programme existant portant le
même nom. Valeurs possibles pour ce paramètre
sont:
0
Ajoute un nouvel élément de programme sans remplacer celui existant. C'est la valeur par défaut.
1
Remplace tout élément de programme existant.
Courir dans son propre espace
Paramètre numérique facultatif. Spécifie si le programme s'exécute dans son propre espace d'adressage. Ce
paramètre s'applique uniquement aux applications Windows 16 bits. Ce paramètre peut avoir les valeurs suivantes :
0
Ne s'exécute pas dans un espace d'adressage séparé. C'est la valeur par défaut.
1
S'exécute dans un espace d'adressage séparé.
commentaires
Il y a une limite de 50 éléments pouvant être ajoutés à chaque groupe de programmes.
Retour
0
Élément de programme ajouté
Exemple
Machine
Machine Translated
Google
KiXtart2010 51
Si AddProgramItem("c:\windows\regedit.exe","RegEdit","",0,"c:\",0,0) = 0
? "Ajout de l'élément de programme 'RegEdit' au groupe actuel..."
Fin si
ASC
Action Renvoie le code ASCII du caractère spécifié.
Syntaxe ASC (personnage)

Paramètre Personnage
Caractère dont vous souhaitez connaître le code ASCII.
Retour Valeur numérique représentant le code ASCII du caractère.
Exemple $ASCII = Asc( "H" )
UN SCANNER
Action
Recherche dans un tableau un élément contenant la même valeur qu'une expression.
Syntaxe ASCAN (tableau, expression, début, longueur, drapeaux)
Paramètres
Tableau Nom du tableau à rechercher.
Expression
Spécifie l'expression à rechercher.
Commencer
Argument facultatif spécifiant le numéro d'élément à partir duquel la recherche commence. Le numéro d'élément que
vous spécifiez est inclus dans la recherche.
Longueur
Valeur facultative spécifiant le nombre d'éléments à analyser. Si vous omettez cette valeur, la recherche continue
jusqu'au dernier élément du tableau.
Flags
Valeur facultative combinant un ou plusieurs indicateurs. Valeurs possibles:
Indicateur (bit) Valeur Action

0 0
Rechercher une correspondance exacte (par défaut).
1
Recherchez un élément contenant la chaîne de recherche.
1 0
Renvoie le premier élément correspondant (par défaut).
1
Renvoie tous les éléments correspondants.
Retour >=0
ID de l'élément qui correspond à l'expression.
Machine Translated
52 KiXtart2010
1
Expression non présente dans le tableau
Exemples $Tableau = 1,2,3,5,7,11,13

$x = ASCAN($Tableau, 3) ; renverra '2'
$Array = 'UneChaîne', 'Une AutreChaîne', 'LastString'

$x = ASCAN($Array, 'autre', , , 1) ; renverra '1'
$Array = 'UneChaîne', 'Une AutreChaîne', 'Dernier'

$x = ASCAN($Array, 'Chaîne', , , 3) ; renverra un tableau contenant
; tous les éléments correspondants
Action Placez le curseur à la position indiquée.
Syntaxe AT (ligne, colonne)

Paramètres Rangée
Spécifie la ligne sur laquelle positionner le curseur.

Colonne
Spécifie la colonne sur laquelle positionner le curseur.
commentaires La position du curseur est exprimée en coordonnées d'écran. Une valeur de 0,0 représente le coin supérieur
gauche de l'écran.
La commande AT est ignorée si toutes les sorties ont été redirigées vers un fichier à l'aide de la
fonction REDIRECTOUTPUT.
Retour
Rien.
JOURNAL DES ÉVÉNEMENTS DE SAUVEGARDE
Action Crée une sauvegarde d'un journal des événements Windows.
Syntaxe BACKUPEVENTLOG ("journal des événements", "fichier de sauvegarde")
Paramètre
Journal des
événements Chaîne indiquant le journal des événements à sauvegarder. Par défaut, Windows
prend en charge trois journaux d'événements : "Application", "Sécurité" et "Système".
Facultativement, la chaîne peut inclure le nom d'un système distant sur lequel sauvegarder le journal.
Fichier de
sauvegarde Chaîne indiquant le nom du fichier de sauvegarde. Remarque : le fichier ne doit pas exister.
Retour
0
Journal des événements sauvegardé.
Machine
Machine Traduit parTranslated
Google by Google
KiXtart2010 53
>0 Code d'erreur.
Exemples BackupEventlog( "Application", "C:\eventbackups\application.evt" )
BackupEventlog( "\\PDC\Application", "C:\eventbackups\application.evt")
BackupEventlog( "Système", "C:\eventbackups\system.evt")
BOÎTE
Action Dessinez une boîte.
Syntaxe BOX (top_left_row, top_left_column, bottom_right_row, bottom_right_column, "style de ligne")
Paramètres Top_left_row, top_left_column, bottom_right_row, bottom_right_column Les quatre coins de la boîte à
dessiner, exprimés en coordonnées d'écran. Une valeur de 0,0 représente le coin supérieur gauche de l'écran.
Style de ligne
Les valeurs possibles pour le style de ligne sont :
célibataire Contour d'une seule ligne, espace comme remplissage
double
Double ligne, espace comme remplissage
complet
Ligne complète, espace comme remplissage
grille Ligne simple, croix comme remplissage
Vous pouvez également créer une zone personnalisée en utilisant une valeur de chaîne pour le style de ligne. La chaîne peut contenir jusqu'à 9 caractères, définis
comme suit.
Ce personnage dans
la chaîne Représente cette partie de la boîte

St
1
Coin supérieur gauche
n/A
2
Dessus horizontal
ème 3
Le coin supérieur droit
le
4
Verticale droite
le
5
Le coin inférieur droit
le
6 Fond horizontal
le
7 Coin inférieur gauche
le
8 Verticale gauche
le
9 Remplisseur
commentaires
La commande BOX est ignorée si toutes les sorties sont redirigées vers un fichier (ou la console) à l'aide de la fonction REDIRECTOUTPUT.
Retour
Machine Translated
Machine Traduit by Google
par Google
54 KiXtart2010
Rien.
BOÎTE (10, 10, 12, 15, "++|++| ") ;
Exemple
produit la boîte suivante :

++
| |
++
CDBL
Action Renvoie une expression qui a été convertie en Variant de soustype Double.
Syntaxe CDBL (expression)

Paramètre Expression
Toute expression valide.
Retour Variante du soustype Double.
CHR
Action Insérez des caractères spéciaux, tels que des retours chariot, dans une chaîne.
Syntaxe CHR (code de caractère)

Paramètre Code de caractère
Une expression numérique représentant le code de caractère à insérer.
Retour La représentation sous forme de chaîne du code de caractère.
$Message = « Bonjour » + @USERID + Chr(13) + Chr(10)+ "Bienvenue dans notre

Exemple
réseau."
CINT
Action Renvoie une expression qui a été convertie en Variant de soustype Integer.
Syntaxe CINT (expression)

Retour Variante du soustype Integer.

Machine
Machine Translated
Google
KiXtart2010 55
commentaires CInt diffère des fonctions Fix et Int, qui tronquent plutôt qu'arrondissent la partie fractionnaire d'un nombre. Lorsque
la partie fractionnaire est exactement 0,5, la fonction CInt l'arrondit toujours au nombre pair le plus proche. Par
exemple, 0,5 arrondit à 0 et 1,5 arrondit à 2.
EFFACER LE JOURNAL DES ÉVÉNEMENTS
Action
Efface un journal des événements Windows.
Syntaxe CLEAREVENTLOG ("journal des événements")
Paramètre
Eventlog
Chaîne indiquant le journal des événements à effacer. Par défaut, Windows prend en charge trois
journaux d'événements : "Application", "Sécurité" et "Système". Facultativement, la chaîne peut inclure le
nom d'un système distant sur lequel effacer le journal.
Retour
0
Journal des événements effacé.
>0 Code d'erreur.
Exemples ClearEventlog("Application")
ClearEventlog( "\\PDC\Application" )
ClearEventlog("Système")
FERMER
Action Ferme un fichier précédemment ouvert par la fonction OPEN.
Syntaxe FERMER (descripteur de fichier)
Paramètre Descripteur de fichier
Expression numérique indiquant le descripteur du fichier à fermer. Les valeurs possibles vont de 1 à 10.
Retour
2
Descripteur de fichier spécifié non valide
0 Dossier fermé
Exemple SI Fermer(3)
Bip
? « Erreur lors de la fermeture du fichier ! »
FIN SI
Machine Translated
56 KiXtart2010
COMPARERFILETIMES
Action Comparez la date et l'heure de deux fichiers.
Syntaxe COMPAREFILETIMES("fichier1", "fichier2")
Paramètre Fichier1
Identifie le premier fichier que vous souhaitez comparer.
Fichier2
Identifie le deuxième fichier que vous souhaitez comparer.
Retour 3
Le fichier 2 n'a pas pu être ouvert (voir @ERROR pour plus d'informations).
2
Le fichier 1 n'a pas pu être ouvert (voir @ERROR pour plus d'informations).
1 Le fichier1 est plus ancien que le fichier2.
0 File1 et file2 ont la même date et heure.
1 Le fichier1 est plus récent que le fichier2.
Exemple $Result = CompareFileTimes (@LDRIVE + "\USER.INI", "C:\WINDOWS\USER.INI")

SI $Résultat = 1 OU $Résultat = 3
COPIER @LDRIVE + "\USER.INI" "C:\WINDOWS\USER.INI"
FIN SI
CRÉER UN OBJET
Action CreateObject lance (si nécessaire) le serveur OLE Automation et renvoie un handle via lequel un objet OLE Automation peut
être manipulé.
Syntaxe CREATEOBJECT("nomclasseserveur.nomtype")
Paramètres Nom de classe de serveur
Le nom de l'application fournissant l'objet.
TypeName
Le type ou la classe de l'objet à créer.
Retour
Si la fonction réussit, elle renvoie le handle de l'objet. Si la fonction échoue, elle renvoie 0.
Exemple $ObjectHandle = CreateObject("WScript.Shell")
CSTR
Action
Renvoie une expression qui a été convertie en Variant de soustype String.
Machine
Machine Translated
Google
KiXtart2010 57
Syntaxe CSTR (expression)

Paramètre
Expression
Retour
Variante du soustype String.
DECTOHEX
Action Renvoie la représentation hexadécimale d'une valeur décimale.
Syntaxe DECTOHEX (Valeur décimale)

Paramètre Valeur décimale
La valeur dont vous souhaitez avoir la représentation hexadécimale.

Retour
Une chaîne représentant la valeur hexadécimale de la valeur d'entrée.
$Résultat = DécVersHex(123)
Exemple
DELKEY
Action
Supprime la sousclé spécifiée du registre.
Syntaxe DELKEY (« sousclé »)

Paramètre
Sousclé
Une chaîne qui spécifie le nom de la sousclé que vous souhaitez supprimer.
commentaires Cet appel échoue si des sousclés existent dans la sousclé spécifiée. Utilisez DELTREE si vous souhaitez supprimer
une sousclé contenant des sousclés.
Retour
0
Sousclé supprimée
Exemple $ReturnCode = DelKey("HKEY_CURRENT_USER\EZReg")

Si $ReturnCode = 0
? « Clé supprimée . »
Fin si
DELPRINTERCONNEXION
Action
Supprime une connexion à une imprimante établie à l'aide de
ADDPRINTERCONNECTION.
Syntaxe DELPRINTERCONNECTION ("nom de l'imprimante")

Machine Translated
58 KiXtart2010
Paramètres Nom de l'imprimante
Chaîne qui spécifie le nom de la connexion d'imprimante à supprimer.
commentaires La fonction DELPRINTERCONNECTION ne supprime aucun fichier de pilote d'imprimante copié du serveur sur
lequel réside l'imprimante lorsque la connexion de l'imprimante a été établie.
Retour
0 Connexion imprimante supprimée
Exemple Si DelPrinterConnection("hplaser4") = 0 ?
« Connexion d'imprimante supprimée. »
Fin si
GROUPE DELPROGRAMME
Action Instructions au gestionnaire de programme pour supprimer un groupe de programmes existant.
Syntaxe DELPROGRAMGROUP ("nom du groupe", indicateur de groupe commun)
Paramètres Nom du groupe

Identifiez le groupe à supprimer.
0
Supprime un groupe personnel.
1
Supprime un groupe commun. L'utilisateur actuel doit disposer de privilèges administratifs, sinon la
fonction échoue.
commentaires Lorsque cette fonction s'exécute, aucune confirmation n'est demandée ni aucun avertissement donné.
Retour
0
Groupe de programmes supprimé
Exemple Si DelProgramGroup("NewGroup", 0) = 0 ?
"NouveauGroupe supprimé..."
Fin si
DELPROGRAMITEM
Action Instructions au gestionnaire de programme pour supprimer un élément du groupe de programmes actif.
Syntaxe DELPROGRAMITEM (« nom de l'élément »)
Paramètre
Machine
KiXtart2010 59
Nom de l'article
Spécifie l'élément à supprimer du groupe de programmes actif.
Retour
0
Élément de programme supprimé
Exemple Si DelProgramItem("Quoi qu'il en soit") = 0

? "ProgramItem 'Whatever' supprimé du groupe actuel...."
Fin si
DELTREE
Action
Supprime une sousclé du registre, y compris toutes les sousclés contenues dans la sousclé spécifiée.
Syntaxe DELTREE ("sousclé")
Paramètre
Sousclé
Spécifie la sousclé à supprimer du registre.
commentaires
Lorsque cette fonction s'exécute, aucune confirmation n'est demandée ni aucun avertissement donné.
Retour
0
Sousclé supprimée
Exemple $ReturnCode = DelTree("HKEY_CURRENT_USER\EZReg")

Si $ReturnCode = 0
? « Clé supprimée . »
Fin si
DELVALEUR
Action
Supprime une entrée de valeur du registre.
Syntaxe DELVALUE("sousclé", "entrée")
Paramètre
Sousclé
Une chaîne qui spécifie le nom de la sousclé à partir de laquelle vous souhaitez supprimer une entrée.
Entrée
Une chaîne qui spécifie le nom de l'entrée que vous souhaitez supprimer.
Retour
0
Entrée de valeur supprimée
Exemple $ReturnCode =DelValue("HKEY_CURRENT_USER\EZReg", "Test")

Machine Translated
60 KiXtart2010
Si $ReturnCode = 0
? « Valeur supprimée. »
Fin si
DIR
Action Dir peut être utilisé pour énumérer les fichiers dans un répertoire. Dir renvoie une chaîne représentant le nom
d'un fichier, d'un répertoire ou d'un dossier qui correspond à un modèle spécifié. Pour récupérer les entrées
suivantes dans un répertoire, spécifiez une chaîne vide ("") comme chemin.
Syntaxe DIR ("chemin", index)
Paramètre Chemin
Chaîne facultative qui spécifie un nom de fichier : peut inclure un répertoire ou un dossier et un lecteur.
Si le chemin est vide (""), Dir renverra le fichier suivant du handle d'énumération précédemment
ouvert. Les caractères génériques (« * » et « ? ») sont pris en charge.
Indice
Numéro facultatif indiquant le handle d’énumération à utiliser. La fonction Dir peut énumérer deux répertoires
en même temps. Pour ouvrir le deuxième handle d’énumération, spécifiez 1 pour l’index.
Retour
Renvoie une chaîne représentant le nom d'un fichier, d'un répertoire ou d'un dossier qui correspond à un
modèle spécifié. Une chaîne vide ("") est renvoyée si le chemin n'est pas trouvé ou pour indiquer que la fin
de l'énumération en cours a été atteinte. Dir définit également la valeur
de @ERREUR :
0 C'est réussi.
Code d'erreur La fonction a échoué.
$NomFichier = Rép("C:\TEMP\*.*")
Exemple
Tandis que $FileName <> "" et @ERREUR = 0
? $NomFichier
$NomFichier = Rép() ; récupérer le fichier suivant
Boucle
ENUMGROUPE
Action Énumère tous les groupes dont l’utilisateur actuel est membre.
Syntaxe ENUMGROUPE (Index)
Paramètre Indice
Une valeur numérique représentant le groupe dont vous souhaitez découvrir le nom (où 0 est la première
sousclé).
Retour
Chaîne Nom de groupe
Machine Translated
KiXtart2010 61
Exemple $Indice = 0
FAIRE
$Groupe = ENUMGROUP($Index)
$Index = $Index + 1
JUSQU'À Len($Groupe) = 0
ENUMIPINFO
Action
Permet l'énumération des informations TCP/IP de toutes les cartes réseau du système local.
Syntaxe ENUMIPINFO (index, type, mode)

Paramètre Indice
Une valeur numérique représentant le groupe d'informations IP que vous souhaitez découvrir (où 0 est le
premier groupe).
Kind
Paramètre facultatif identifiant le type d’informations que vous souhaitez énumérer.
0 adresse IP
1 Masque de sousréseau
2
Adapter la description
3
Passerelle par défaut
Mode
Paramètre facultatif indiquant si EnumIPInfo doit ou non redécouvrir les informations IP du système. Si ce
paramètre est omis, EnumIPInfo récupère les informations IP du système lors du premier appel, met en cache les
informations et réutilise les informations lors des appels suivants dans la session KiXtart en cours. Valeurs
possibles:
0 Réutilisez les informations mises en cache.
1
Récupérez les informations IP actuelles du système.
Retour
Une chaîne représentant les informations demandées.
commentaires
Cette fonction concerne une installation correcte de l'API IP Helper qui est installée dans le cadre de Microsoft Internet
Explorer 5.0 et supérieur.
Exemple $Résultat = EnumIPInfo()

Machine
62 KiXtart2010
CLÉÉNUM
Action
Répertorie les noms des sousclés contenues dans une clé de registre ou une sousclé.
Syntaxe ENUMKEY("sousclé", index)
Paramètres Sousclé
Spécifie la clé ou la sousclé pour laquelle vous souhaitez énumérer les sousclés.
Indice
Une valeur numérique représentant la position de la sousclé dont vous souhaitez découvrir le nom.
Zéro (0) représente la première sousclé de la clé.
Retour
0
La fonction renvoie une chaîne représentant la sousclé dans la clé spécifiée
259
La sousclé n'existe pas
$Indice = 0
Exemple
:Boucle1
$KeyName = ENUMKEY("HKEY_CURRENT_USER\Console\ ", $Index)

Si @ERREUR = 0
? "Nom trouvé : $KeyName"

$Index = $Index + 1
aller à la boucle 1
Fin si
ENUMLOCALGROUPE
Action
Énumère l'appartenance au groupe local de l'utilisateur actuel sur un domaine approuvé ou un membre
serveur.
Syntaxe ENUMLOCALGROUP(index, "source")
Paramètre Indice
Une valeur numérique représentant le groupe dont vous souhaitez découvrir le nom (où 0 est la première sousclé).
Source
Valeur de chaîne représentant le serveur ou le domaine dont vous souhaitez interroger les groupes locaux.
commentaires
L'appartenance à un groupe local dans le domaine de connexion peut être énumérée à l'aide
de ENUMGROUP. EnumLocalGroup est destiné aux groupes locaux dans d'autres domaines ou sur des serveurs membres.
Retour Chaîne Nom du groupe local

Machine
Machine Translated
Google
KiXtart2010 63
Exemple $Indice = 0
FAIRE
$Groupe = ENUMLOCALGROUP($Index)
$Index = $Index + 1
Or
$Indice = 0
FAIRE
$Groupe = ENUMLOCALGROUP($Index, "\\MonServeur")

$Index = $Index + 1
ÉNUMVALEUR
Action
Répertorie les noms des entrées de registre contenues dans une clé ou sousclé spécifique.
Syntaxe ENUMVALUE ("sousclé", index)

Spécifie la clé ou la sousclé pour laquelle vous souhaitez énumérer les entrées de valeur.
Indice
Une valeur numérique représentant la position de l'entrée dont vous souhaitez découvrir
le nom. Zéro (0) représente la première entrée de la sousclé.
Retour
0
La fonction renvoie une chaîne représentant l'entrée dans la clé ou sousclé spécifiée
259
L'entrée n'existe pas
Exemple $Indice = 0
:Boucle1
$ValueName = ENUMVALUE("HKEY_CURRENT_USER\Console\Configuration",
$Index)
Si @ERREUR = 0
? "Nom trouvé : $ValueName"
$Index = $Index + 1
aller à la boucle 1
Fin si
Machine
Machine Translated
Google
64 KiXtart2010
RÉALISÉ
Action
Exécutez un morceau de code de script KiXtart.
Syntaxe EXÉCUTER (code de script)

Paramètre Code de
script Une expression de chaîne représentant le code à exécuter.
Retour
Le code de sortie du script exécuté.
Exemples $Rc = Execute( '? "Ceci est une démo de la fonction Execute()"' )
$Rc = Exécuter('$$X = 10') ; notez le '$' supplémentaire
'
$Rc = Exécuter( '$$X = + @USERID )
EXISTER
Action Vérifie l'existence d'un ou plusieurs fichiers.
Syntaxe EXISTE (« nom de fichier »)

Paramètres Nom de fichier
Identifiez le(s) fichier(s) que vous souhaitez localiser.

commentaires
Supports génériques.
Retour
0 Fichier introuvable
1 Fichier trouvé
Exemples SI EXISTE (@LDRIVE + "\users.txt")

AFFICHER @LDRIVE + "\users.txt"
FIN SI
SI EXISTE (@LDRIVE + "\*.INI")
; Etc.
FIN SI
CLÉ EXISTE
Action
Vérifie l’existence d’une sousclé de registre.
commentaires
EXISTKEY n'est pris en charge que pour des raisons de compatibilité ascendante. Les nouveaux scripts doivent utiliser la
nouvelle fonction KEYEXIST .
Machine Translated
KiXtart2010 65
ÉLARGIR LES VARS D'ENVIRONNEMENT
Action Développe toutes les variables d'environnement à l'intérieur d'une chaîne en la valeur de texte brut
correspondante.
Syntaxe EXPANDENVIRONMENTVARS ("chaîne")

Paramètre
String
La chaîne que vous souhaitez développer.
Retour
La chaîne développée.
Exemple $Value = ReadValue("HKLM\Système\CurrentControlset\Control\Windows",

"Répertoire Système")
? DévelopperEnvironmentVars( $Value )
RÉPARER
Action Fix supprime la partie fractionnaire du nombre et renvoie la valeur entière résultante.
Notez que si le nombre est négatif, Fix renvoie le premier entier négatif supérieur ou égal au nombre. Par exemple,
Fix convertit 6,3 en 6.
Syntaxe CORRIGER (expression)
Paramètre
Expression
Retour
Variante du soustype Integer.
FORMATNUMÉRO
Action Renvoie une expression formatée sous forme de nombre.
Syntaxe FORMATNUMBER (expression, décimales, chiffre initial, parenthèses, groupe)

Paramètre
Expression
Nombre de décimales
Valeur numérique facultative indiquant combien de places à droite de la décimale sont affichées. La valeur par
défaut est 1, ce qui indique que les paramètres régionaux de l'ordinateur sont utilisés.
Machine
66 KiXtart2010
Chiffre principal
Constante à trois états facultative qui indique si un zéro non significatif est affiché pour
valeurs fractionnaires. Voir cidessous pour les valeurs.
Parenthèses
Constante à trois états facultative qui indique s’il faut ou non placer des valeurs négatives entre parenthèses. Voir ci
dessous pour les valeurs.
Groupe
Constante à trois états facultative qui indique si les nombres sont regroupés ou non à l'aide du délimiteur de groupe spécifié dans le
panneau de configuration. Voir cidessous pour les valeurs.
Valeurs possibles pour les constantes à trois états :
1 Vrai.
0 FAUX.
2
Utilisez le paramètre des paramètres régionaux de l'ordinateur.
Retour Numéro formaté.
POIGNÉE DE FICHIER GRATUIT
Action Renvoie le premier handle de fichier disponible.
Syntaxe POIGNÉE DE FICHIER LIBRE ( )
Paramètres Aucun
Retour
0 Aucun descripteur de fichier disponible
>0 Descripteur de fichier
Exemple $Poignée = FreeFileHandle()

SI $Poignée > 0
SI Ouvert($Handle, @LDRIVE + "\CONFIG\SETTINGS.INI") = 0

………
FIN SI
FIN SI
OBTENIRLIGNE DE COMMANDE
Action Renvoie la ligne de commande utilisée pour démarrer KiXtart.
Syntaxe OBTENIR LIGNE DE COMMANDE (Mode)
Paramètres
Machine
Machine Translated
Google
KiXtart2010 67
Mode
Paramètre entier facultatif indiquant comment la ligne de commande doit être renvoyée.
Valeurs possibles:
0
Renvoie la ligne de commande sous la forme d’une chaîne unique non traitée (par défaut).
1
Renvoie la ligne de commande sous forme de tableau de chaînes.
Retour
Chaîne ou tableau contenant la ligne de commande.
$CL = GetCommandLine(1)
Exemples
POUR CHAQUE $Arg dans
$CL ? $Arg
SUIVANT
OBTENIRESPACE DISQUE
Action
Renvoie le nombre de kilooctets (Ko) disponibles pour l'utilisateur actuel sur un lecteur spécifique.
Syntaxe GETDISKSPACE("lecteur")
Paramètre Conduire
Chaîne qui spécifie un répertoire sur le disque qui vous intéresse. Cette chaîne peut être un nom UNC. Si ce
paramètre est un nom UNC, vous devez le suivre d'une barre oblique inverse supplémentaire. Par exemple,
vous spécifieriez \\MyServer\MyShare comme \\MyServer\MyShare\.
Si Drive est une chaîne vide, GetDiskSpace obtient des informations sur le disque qui contient le répertoire actuel.
Retour
Nombre représentant le nombre de kilooctets (Ko) disponibles pour l'utilisateur actuel sur le lecteur spécifié.
Exemples
$Résultat = GetDiskSpace( "C:\" )
$Résultat = GetDiskSpace( "X:\MARKETING" )
GETFILEATTR
Action Renvoie les attributs d'un fichier.
Syntaxe GETFILEATTR ("nom de fichier")

Paramètre Nom de fichier
Identifiez le fichier dont vous souhaitez récupérer les attributs.

Retour
Machine
Machine Translated
Google
68 KiXtart2010
Zéro pour indiquer que la fonction a échoué. Si la fonction échoue, vérifiez @ERROR pour plus de détails sur l'erreur.
Sinon, la valeur de retour représente les attributs du fichier. Les attributs peuvent être un ou plusieurs
des valeurs suivantes : Lecture seule 1 Le fichier ou répertoire est lu
Candidatures uniquement. peut lire le fichier mais ne peut pas y écrire ni le supprimer. Dans le cas d'un répertoire, les applications
impossible de le supprimer.
2 Caché
Le fichier ou le répertoire est masqué. Il n'est pas inclus dans un répertoire ordinaire
référencement.
4
Système Le fichier ou le répertoire fait partie du système d'exploitation ou est utilisé exclusivement par celuici.
système.
16
Annuaire Le nom de fichier identifie un répertoire.
32 Archive
Le fichier ou le répertoire est un fichier ou un répertoire d'archive.
Les applications utilisent cet attribut pour marquer les fichiers à sauvegarder ou à supprimer.
64
Crypté Le fichier ou le répertoire est crypté. Pour un fichier, cela signifie que toutes les données
les flux sont cryptés. Pour un répertoire, cela signifie que le cryptage est la valeur par défaut
pour les fichiers et sousrépertoires nouvellement créés.
128 Normale
Le fichier ou le répertoire n'a aucun autre attribut défini. Cet attribut est valide uniquement
s'il est utilisé seul.
256 Temporaire Le fichier est utilisé pour le stockage temporaire. Les systèmes de fichiers tentent de
conserver toutes les données en mémoire pour un accès plus rapide plutôt que de
renvoyer les données vers le stockage de masse. Un fichier temporaire
doit être supprimé par l’application dès qu’il n’est plus nécessaire.
512
Fichier fragmenté Le fichier est un fichier fragmenté.
1024 Point d'analyse Le fichier est associé à un point d'analyse.
2048 compressé Le fichier ou le répertoire est compressé. Pour un fichier, cela signifie que tous les
les données du fichier sont compressées. Pour un répertoire, cela signifie que la
compression est la valeur par défaut pour les fichiers et sousrépertoires nouvellement créés.
4096 Hors ligne

Les données du fichier ne sont pas immédiatement disponibles. Indique que le fichier
les données ont été physiquement déplacées vers un stockage hors ligne.
Exemple
$Résultat = GetFileAttr (@LDRIVE + "\Kix32.exe")
SI GetFileAttr( "C:\TEMP" ) & 16 ; notez l'utilisation de l'opérateur '&'
; pour vérifier juste le bit 4
? "C:\temp est un répertoire !"

FIN SI
GETFILESIZE
Action
Renvoie la taille d'un fichier en octets.
Machine
Machine Translated
Google
KiXtart2010 69
Syntaxe GETFILESIZE (« nom de fichier »)

Identifiez le fichier dont vous souhaitez récupérer la taille.

Retour Taille du fichier en octets.
commentaires La taille maximale des fichiers dont GetFileSize peut correctement signaler la taille est de 2 147 483 647
octets.
Exemple $Résultat = GetFileSize (@LDRIVE + "\Kix32.exe")
GETFILETIME
Action Renvoie les informations de date et d'heure d'un fichier.
Syntaxe GETFILETIME ("nom de fichier", Mode)

Identifiez le fichier pour lequel vous souhaitez récupérer les informations de date et d'heure.
Temps
Paramètre entier facultatif indiquant quelles informations de date/heure GetFileTime doit renvoyer. Valeurs
possibles:
0
Renvoie l'heure de la dernière écriture (par défaut).
1 Renvoie l’heure de création.
2 Renvoie l’heure du dernier accès.
Mode
Paramètre entier facultatif indiquant si et comment l’heure renvoyée doit être ajustée à l’heure d’été.
Valeurs possibles:
0
Ajustez l’heure en utilisant l’heure d’été actuelle (par défaut).
1
Ajustez l’heure en utilisant l’heure d’été de l’heure stockée.
2
Ne réglez pas l'heure (retour UTC).
Retour Une chaîne représentant la date et l'heure du fichier au format « AAAA/MM/JJ HH:MM:SS ».
Exemple $Résultat = GetFileTime (@LDRIVE + "\Kix32.exe")
OBTENIRFILEVERSION
Action Renvoie une chaîne d'informations sur la version d'un fichier.
Syntaxe GETFILEVERSION ("nom de fichier", "champ de version")

Machine Translated
70 KiXtart2010
Identifiez le fichier pour lequel vous souhaitez obtenir la chaîne de version.
Champ Version
Paramètre facultatif identifiant le champ d’informations de version spécifique qui doit être récupéré. Par
défaut, le champ FileVersion est renvoyé. Valeurs possibles pour ce champ
sont:
VersionFichierBin
Renvoie une représentation sous forme de chaîne des informations sur la version
du fichier binaire (par exemple : "4.22.0.0").
BinProductVersion Renvoie une représentation sous forme de chaîne de la version binaire du produit
informations (par exemple : "4.22.0.0").
commentaires
Ce champ contient toutes les informations supplémentaires qui doivent être
affichées à des fins de diagnostic.
Nom de l'entreprise Ce champ identifie l'entreprise qui a produit le fichier. Par exemple, «
Microsoft Corporation » ou « Standard Microsystems
Corporation, Inc. »
Description du fichier Ce champ décrit le fichier de manière à ce qu'il puisse être présenté
aux utilisateurs. Cette chaîne peut être présentée dans une zone de liste lorsque
l'utilisateur choisit les fichiers à installer. Par exemple, « Pilote de
clavier pour claviers de style AT » ou « Microsoft Word pour Windows ».
Version du fichier Ce membre de champ identifie la version de ce fichier. Pour
exemple, "3.00A" ou "5.00.RC2".
Nom interne Ce champ identifie le nom interne du fichier, s'il existe. Par exemple, cette
chaîne peut contenir le nom de module pour une bibliothèque de liens
dynamiques (DLL), un nom de périphérique virtuel pour un périphérique
virtuel Windows ou un nom de périphérique pour un pilote de périphérique
MSDOS.
Langue Nom anglais complet de la langue du fichier spécifié dans le format défini par
la norme ISO 639. (exemple : "0413Dutch (Standard)").
LégalCopyright Ce champ décrit tous les avis de droits d'auteur, marques commerciales et
marques déposées qui s'appliquent au fichier. Cela doit inclure le texte
intégral de tous les avis, symboles légaux, droits d'auteur
dates, numéros de marque, etc. En anglais, cette chaîne
Machine Translated
KiXtart2010 71
doit être au format « Copyright Microsoft Corp. 1990–

1994".
LegalTrademarks Ce champ décrit toutes les marques commerciales et marques déposées qui s'appliquent
au fichier. Cela doit inclure le texte intégral de tous les avis, symboles légaux,
numéros de marque, etc.
En anglais, cette chaîne doit être au format « Windows est une marque
déposée de Microsoft Corporation ».
OriginalFilename Ce champ identifie le nom d'origine du fichier, sans inclure le chemin. Cela
permet à une application de déterminer si un fichier a été renommé par un
utilisateur. Ce nom peut ne pas être au format MSDOS 8.3 si le fichier
est spécifique à un système de fichiers non FAT.
Construction privée
Ce champ décrit par qui, où et pourquoi cette version privée du fichier a été
créée. Par exemple, « Construit par OSCAR sur \OSCAR2 ».
Nom du produit
Ce champ identifie le nom du produit avec lequel ce fichier est distribué. Par
exemple, cette chaîne pourrait être « Microsoft Windows ».
Version de produit
Ce champ identifie la version du produit avec lequel ce fichier est distribué. Par
exemple, « 3.00A » ou « 5.00.RC2 ».
Ce champ décrit en quoi cette version du fichier diffère de

Construction spéciale
la version normale. Par exemple, « Version privée pour Olivetti résolvant les
problèmes de souris sur les ordinateurs M250 et M250E ».
Retour Une chaîne représentant le champ de version du fichier.

commentaires Les informations renvoyées par cette fonction sont les mêmes que les informations de version affichées
dans l'Explorateur Windows.
Cette fonction s'applique uniquement aux fichiers exécutables Windows 32 bits.
$Résultat = GetFileVersion (@LDRIVE + "\Kix32.exe")

Exemple
$Result = GetFileVersion (@LDRIVE + "\Kix32.exe", "ProductVersion")

Machine Translated
72 KiXtart2010
OBJET
Action GetObject récupère un objet à partir d'un fichier stocké sur le disque et renvoie un handle vers l'objet.
Syntaxe GETOBJECT("nom de l'objet")
Paramètres ObjectName
Chemin complet et nom du fichier contenant l'objet à récupérer. Si le chemin d’accès est omis, la
classe est requise.
Retour Si la fonction réussit, elle renvoie le handle de l'objet. Si la fonction échoue, elle renvoie 0 et @ERROR
sera défini sur un code d'erreur pertinent.
Exemple $ObjectHandle = GetObject("LDAP://localhost")
IIR
Action Renvoie l'une des deux valeurs en fonction de la valeur d'une expression logique.
Syntaxe IIF(expression, valeur de retour1, valeur de retour2)
Paramètres Expression
Spécifie l'expression logique évaluée par IIF( ).
Valeur de retour1
Si l’expression est évaluée à true, ReturnValue1 est renvoyé par IIF.

Valeur de retour2
Si l'expression est évaluée à false, ReturnValue2 est renvoyé par IIF.
Retour ReturnValue1 ou ReturnValue2, selon l'expression.

Exemple POUR CHAQUE $Element IN
$Array $Total = $Total + IIF($Element = "SomeValue", 10, 99)
SUIVANT
EN GROUPE
Action Vérifie si l'utilisateur actuel est membre d'un ou plusieurs groupes.
Syntaxe INGROUP ("nom du groupe" [<,> "nom du groupe 2"], Mode)

Paramètre …
Nom du groupe1, nom du groupe 2, nom du groupe
Identifie le(s) groupe(s) dans lequel(s) vérifier l'appartenance de l'utilisateur. Plusieurs noms de
groupes peuvent être transmis comme arguments. Alternativement, vous pouvez spécifier un seul, un
Machine
KiXtart2010 73
dimensionnel, tableau dont le ou les éléments sont les noms d'un ou plusieurs groupes à tester.
Mode
Paramètre entier facultatif indiquant si Ingroup vérifie ou non l'appartenance au groupe de
un ou tous les groupes de la liste (par défaut = 0). Valeurs possibles:
0
Ingroup vérifie l'appartenance à UN des groupes de la liste (par défaut).
1
Ingroup vérifie l'appartenance à TOUS les groupes de la liste.
commentaires
INGROUP peut être utilisé pour vérifier l'appartenance à des groupes qui existent sur le domaine ou le serveur sur lequel le
l'utilisateur est connecté ou pour vérifier l'appartenance à un groupe sur un domaine ou un serveur spécifique.
Lors de la recherche d'un groupe local, INGROUP identifie que l'utilisateur est indirectement membre du groupe en vertu
d'être membre d'un groupe mondial qui, à son tour, est membre du groupe local.
Si vous souhaitez vérifier l'appartenance à un groupe sur un domaine ou un serveur spécifique, utilisez le format suivant :
"Autredomaine\groupe"
Or
"\\UnServeur\groupe"
Retour
0
L'utilisateur n'est membre d'aucun des groupes spécifiés.
1
L'utilisateur est membre d'un ou plusieurs groupes.
Exemple SI INGROUP("Utilisateurs du domaine")

AFFICHER "z:\users.txt"
FIN SI
SI INGROUP("Développeurs", "Testeurs") = 1
? "Membre du groupe Développeurs OU Testeurs"
FIN SI
SI INGROUP("Développeurs", "Testeurs", 1) = 1
? "Membre du groupe Développeurs ET Testeurs"
FIN SI
$Array = "Développeurs", "Testeurs"

SI INGROUP($Array, 1) = 1 ?
"Membre du groupe Développeurs ET Testeurs"
FIN SI
SI INGROUP("\\" + @WKSTA + "\Developers") = 1

? "Membre des développeurs sur le système local"
FIN SI
Machine Translated
74 KiXtart2010
INSTRUMENT
Action Recherche dans une chaîne la présence d'une deuxième chaîne.
Syntaxe INSTR("chaîne1", "chaîne2")
Paramètres String1
La chaîne dans laquelle rechercher.
String2
La chaîne à rechercher.
Retour
?
Décalage du premier caractère de chaîne2 trouvé dans chaîne1, compté depuis le début de
chaîne1
0
String2 non présent dans string1
Exemple $x = INSTR (@DOMAINE, "TEST") ; vérifier si le domaine contient la chaîne

"TEST"
INSTRREV
Action
Recherche dans une chaîne la présence d'une deuxième chaîne. La recherche démarre à la fin de la chaîne
source. Notez que le décalage renvoyé est compté à partir du début de la chaîne source.
Syntaxe INSTRREV("chaîne1", "chaîne2")
Paramètres String1
La chaîne dans laquelle rechercher.
String2
La chaîne à rechercher.
Retour
?
Décalage du premier caractère de chaîne2 trouvé dans chaîne1, compté depuis le début de
chaîne1
0
String2 non présent dans string1
Exemple $x = INSTRREV (@CURDIR, "\") ; trouver la dernière barre oblique inverse dans @CURDIR
INT
Action Int supprime la partie fractionnaire du nombre et renvoie la valeur entière résultante.
Machine Translated
KiXtart2010 75
Notez que si le nombre est négatif, Int renvoie le premier entier négatif inférieur ou égal au nombre. Par exemple,
Int convertit 6,3 en 7.
Syntaxe INT (expression)

Paramètre
Expression
Retour
Variante du soustype Integer.
EST DÉCLARÉ
Action Renvoie une valeur booléenne indiquant si une variable a été déclarée.
Syntaxe EST DÉCLARÉ (variable)

Paramètre Variable
Requis. Nom de la variable à vérifier.

Retour Un booléen.
Exemple Si EstDéclaré( $MaVar )

….
Fin si
REJOINDRE
Action
Renvoie une chaîne créée en joignant un certain nombre de souschaînes contenues dans un tableau.
Syntaxe JOIN (tableau, "délimiteur", nombre)

Paramètre
Tableau
requis. Tableau unidimensionnel contenant des souschaînes à joindre.
Délimitation
Facultatif. Caractère de chaîne utilisé pour séparer les souschaînes dans la chaîne renvoyée. S'il est omis, le
caractère espace (" ") est utilisé. Si le délimiteur est une chaîne de longueur nulle (""), tous les éléments de la
liste sont concaténés sans délimiteur.
Compter
Facultatif. Nombre d'éléments du tableau à rejoindre.

Retour Une lanière.
Exemple $Monarray = "aaa", "bbb", "ccc"
$String = Rejoindre( $Montableau, "=" ) ; $string contient désormais "aaa=bbb=ccc"
$String = Rejoindre( $Monarray, "=", 2 ) ; $string contient désormais "aaa=bbb"

Machine
Machine Translated
Google
76 KiXtart2010
KBHIT
Action Vérifie la console pour la saisie au clavier.
Syntaxe KBHIT()
Retour <>0
Frappe en attente dans le tampon du clavier Non
0 frappe dans le tampon du clavier.
Exemple SI KbHit()
Obtenez x $ ; récupérer la frappe du tampon
FIN SI
KEYEXISTE
Action Vérifie l’existence d’une sousclé de registre.
Syntaxe KEYEXIST("sousclé")
Paramètre
Sousclé
Identifie la sousclé que vous souhaitez localiser.
commentaires KEYEXIST remplace la fonction EXISTKEY trouvée dans les versions précédentes de KiXtart.
Bien que fonctionnellement équivalents, les codes de retour sont désormais inversés, ce qui entraîne un
comportement similaire à la fonction EXIST.
Retour
0 Sousclé introuvable
1
Sousclé trouvée
Exemple $ReturnCode = KeyExist("HKEY_CURRENT_USER\Console\Configuration")

Si $ReturnCode
? "La clé existe..."
Fin si
CASE
Action Renvoie une chaîne en minuscule.
Syntaxe LCASE("chaîne")
Paramètres Chaîne
La chaîne que vous souhaitez mettre en minuscules.
Retour
La chaîne d'entrée en minuscules.
Exemple $x = LCASE (@USERID)

Machine
Machine Translated
Google
KiXtart2010 77
GAUCHE
Action Renvoie un nombre spécifié de caractères à partir du côté gauche d'une chaîne.
Syntaxe GAUCHE ("chaîne", longueur)
Paramètres Chaîne
Expression de chaîne à partir de laquelle les caractères les plus à gauche sont renvoyés.
Longueur
Expression numérique indiquant le nombre de caractères à renvoyer. Si 0, une chaîne de longueur nulle est
renvoyée. S'il est supérieur ou égal au nombre de caractères de la chaîne, la chaîne entière est renvoyée. La
spécification d'une valeur négative fera que Left renverra le nombre de caractères égal à la longueur totale
de la chaîne moins la valeur spécifiée.
Retour La souschaîne demandée.
Exemple $x = GAUCHE (@USERID, 2) ; récupère les 2 premiers réservoirs de l'ID utilisateur
LEN
Action Renvoie la longueur d'une chaîne.
Syntaxe LEN ("chaîne")
Paramètre Chaîne
La chaîne dont vous souhaitez découvrir la longueur.
Retour Le nombre de caractères contenus dans la chaîne spécifiée.
Exemple $x = LEN (@USERID)
CHARGEMENT
Action Crée une sousclé sous HKEY_USERS ou HKEY_LOCAL_MACHINE et stocke les informations
d'enregistrement d'un fichier spécifié dans cette sousclé. Ces informations d’enregistrement se
présentent sous la forme d’une ruche. Une ruche est un corps discret de clés, de sousclés et de valeurs ancré
au sommet de la hiérarchie du registre. Une ruche est soutenue par un seul fichier et un fichier .LOG.
Syntaxe LOADHIVE (« clé », « nom de fichier »)
Paramètres Clé
Clé dans laquelle vous souhaitez charger les informations. Cette clé doit résider sous
HKEY_LOCAL_MACHINE ou HKEY_USERS.
Machine Translated
78 KiXtart2010
Nom de fichier
Identifiez le fichier à partir duquel vous souhaitez charger les informations. Ce fichier spécifié doit être une ruche
de registre légal (créée par SAVEKEY ou à partir de REGEDT32.EXE).
commentaires
LOADHIVE nécessite des privilèges de sauvegarde et de restauration.
Retour
0 Ruche chargée
Exemple $ReturnCode = LoadHive("HKEY_USERS\EZReg", "c:\temp\tst.reg")

Si $ReturnCode = 0 ?
« Ruche chargée… »
Fin si
CLÉ DE CHARGEMENT
Action
Charge une clé de registre (y compris ses sousclés et valeurs) à partir d'un fichier.
Syntaxe LOADKEY ("sousclé", "nom de fichier")
La sousclé dans laquelle vous souhaitez charger les informations. Cette sousclé doit exister pour que l’appel
aboutisse.
Nom de fichier
Identifiez le fichier à partir duquel importer les informations. Ce fichier doit être un fichier ruche de registre
valide créé à l'aide de la fonction SAVEKEY ou à l'aide d'un éditeur de registre.
commentaires
LOADKEY nécessite des privilèges de sauvegarde et de restauration.
Caution
LOADKEY importe les informations dans le registre et écrase toute sousclé existante. Cela
remplace toutes les sousclés et valeurs qui peuvent déjà
exister dans la sousclé que vous chargez. Toutes les valeurs et sousclés existantes sont perdues.
Retour
0
Sousclé chargée
Exemple $ReturnCode = LoadKey("HKEY_CURRENT_USER\KiXtart", "c:\temp\tst.reg")

Si $ReturnCode = 0
? «Clé chargée…»
Fin si
Machine
Machine Translated
Google
KiXtart2010 79
LOGEÉVÉNEMENT
Action
Enregistre un événement dans le journal des événements Windows.
Syntaxe LOGEVENT (type, ID, message, cible, source)
Paramètre Gentil
Numéro représentant le type d'événement. Valeurs possibles:
0 SUCCÈS
1 ERREUR
2 AVERTISSEMENT
4 INFORMATION
8 AUDIT_SUCCÈS
16
AUDIT_FAILURE
IDENTIFIANT
Numéro représentant l'événement survenu.
Message
Texte du message de l'événement. Notez que la longueur du message est limitée à 32 000 caractères.
Target
Paramètre facultatif représentant le nom UNC du système sur lequel l'événement doit être enregistré. Par défaut,
tous les événements sont enregistrés sur le système local.
Source
Paramètre facultatif représentant la source de l'événement. Si ce paramètre n'est pas spécifié, Kixtart assumera le
KIX32.EXE comme source de l'événement.
Retour
0
Événement enregistré
, 1
Exemple $RC = JournalEvénement( 0 , "Script de connexion terminé avec succès" , "",
"MonÉvénement")
, 1
$RC = JournalEvénement( 0 , "Script de connexion terminé avec succès")
, 1 , @LSERVEUR)
$RC = JournalEvénement(1 , "Le script de connexion a échoué !"
SE DÉCONNECTER
Action
Déconnecte l'utilisateur actuel et met fin à la session Windows.
Syntaxe LOGOFF (force)
Paramètre
Machine
Machine Translated
Google
80 KiXtart2010
Force
Lors d'une opération de déconnexion, les applications arrêtées disposent d'un délai spécifique pour
répondre à la demande de déconnexion. Si le délai expire, Windows affiche une boîte de dialogue qui
permet à l'utilisateur de forcer l'arrêt de l'application, de réessayer la déconnexion ou d'annuler la demande de
déconnexion. Si la valeur Force est vraie (c'estàdire non nulle), Windows force toujours la fermeture des
applications et n'affiche pas la boîte de dialogue.
0
Windows ne force pas la fermeture des applications.
1
Windows force toujours la fermeture des applications et n'affiche pas la boîte de dialogue.
Retour
0
Utilisateur déconnecté
$RC = Déconnexion(0)
Exemple
LTRIM
Action Supprime les espaces de début d’une chaîne d’entrée et renvoie le résultat.
Syntaxe LTRIM("chaîne")
Paramètre
String
La chaîne à partir de laquelle supprimer les espaces de début.
Retour
La chaîne d'entrée sans espaces de début.
Exemple
$x = LTRIM(SUBSTR (@IPADDRESS0, 1, 3)); 192
TAILLE MÉMOIRE
Action Renvoie les statistiques de mémoire, en mégaoctets.
Syntaxe TAILLE MÉMOIRE (type)

Paramètre Gentil
Numéro facultatif, indiquant le type de mémoire sur lequel vous souhaitez obtenir des statistiques. Valeurs possibles:
0
Mémoire physique totale (par défaut)
1
Mémoire physique disponible
2
Taille totale du fichier d'échange
3 Espace disponible dans le fichier d'échange

Machine
KiXtart2010 81
Retour
La quantité de mémoire, en mégaoctets.
Exemple $x = Taille Mémoire()
MESSAGERIE
Action
Affiche une boîte de dialogue standard sous Windows.
Syntaxe MESSAGEBOX ("message", "titre", style, timeout)
Paramètres Message Le
message à afficher dans la boîte de dialogue.
Titre
Le titre de la boîte de dialogue.
Style
Expression numérique facultative qui est la somme de valeurs spécifiant le nombre et le type de boutons à afficher, le style d'icône
à utiliser, l'identité du bouton par défaut et la modalité. Le tableau suivant illustre les valeurs utilisées et la signification de chaque
groupe de valeurs.
Boutons à afficher
Valeur
Signification
0
Afficher uniquement le bouton OK.
1
Affichez les boutons OK et Annuler.
2
Afficher les boutons Abandonner, Réessayer et Ignorer.
3
Affichez les boutons Oui, Non et Annuler.
4
Affichez les boutons Oui et Non.
5
Afficher les boutons Réessayer et Annuler.
Icône à afficher
Valeur
Signification
16
Symbole d'arrêt
32 Point d'interrogation
48 Point d'exclamation
64
Symbole d'information
Bouton par défaut
Valeur
Signification
0 Le premier bouton est par défaut.
256 Le deuxième bouton est par défaut.
512 Le troisième bouton est par défaut.

Machine
82 KiXtart2010
Modalité
Valeur
Signification
0
Applicationmodal. L'utilisateur doit répondre à la boîte de message avant de continuer à
travailler dans l'application.
4096
Systèmemodal. Toutes les applications sont suspendues jusqu'à ce que l'utilisateur réponde à la
boîte de message.
Lorsque vous ajoutez des nombres pour créer une valeur finale pour le type d'argument, utilisez un seul nombre de chaque
groupe. Si le style est omis, une valeur par défaut de 0 est supposée.
Temps mort
Expression numérique facultative représentant le nombre de secondes après lequel fermer la boîte de dialogue.
Note
La fonctionnalité de délai d'attente ne fonctionne que si la boîte de dialogue MESSAGEBOX est la fenêtre
active pendant la durée du délai d'attente. Si l'utilisateur s'éloigne de
KiXtart et active une autre application, la boîte de dialogue MESSAGEBOX n'est pas fermée.
commentaires
MESSAGEBOX affiche un maximum de 1 024 caractères dans les boîtes de dialogue modales d'application. Les messages plus
longs sont tronqués après le 1024ème caractère. Les chaînes de message de plus de 255 caractères sans espaces
intermédiaires sont tronquées après le 255ème caractère. Pour les boîtes de dialogue modales système, le nombre de caractères
que vous pouvez afficher dépend de la résolution de l'écran et du nombre de lignes dans le fichier.
message.
MESSAGEBOX coupe automatiquement les lignes sur le bord droit de la boîte de dialogue. Si vous souhaitez définir vousmême
des sauts de ligne, placez un saut de ligne (caractère ANSI 10) avant le premier caractère du texte qui doit commencer chaque
nouvelle ligne.
Retour
La valeur renvoyée par MESSAGEBOX indique quel bouton a été sélectionné, comme indiqué dans le tableau suivant.
Valeur
Signification
1
L'utilisateur n'a pas répondu à la boîte de dialogue dans le délai spécifié.
1 Bouton OK sélectionné.
2 Bouton Annuler sélectionné.
3 Bouton Abandonner sélectionné.
4
Bouton Réessayer sélectionné.
5
Bouton Ignorer sélectionné.
6 Bouton Oui sélectionné.
7 Aucun bouton sélectionné.
Si la boîte de dialogue contient un bouton Annuler, appuyer sur ESC a le même effet que choisir Annuler.
Exemple $Selection = MessageBox("Voulezvous continuer ?", "KiXtart", 36)

Si $Sélection = 6
Machine Translated
KiXtart2010 83
? "Oui sélectionné, continue..."

Fin si
OUVRIR
Action
Ouvrez un fichier texte.
Syntaxe OPEN (descripteur de fichier, "nom de fichier", mode)
Paramètres Descripteur de fichier
Expression numérique indiquant le handle du fichier à ouvrir. Les valeurs possibles vont de 1 à 10.
Nom de fichier
Une expression de chaîne indiquant le chemin et le nom du fichier ASCII à ouvrir.

Mode
Paramètre facultatif qui indique ce qui doit se passer si le fichier n'existe pas.
Ce paramètre peut avoir les valeurs suivantes :
0 Si le fichier n'existe pas, OPEN échoue avec le code retour 2 (par

défaut).
1 Si le fichier n'existe pas, OPEN créera un nouveau fichier.
2
Ouvre le fichier pour un accès en lecture (par défaut).
4
Ouvre le fichier pour un accès en écriture.
Note
Ces valeurs sont cumulatives. Ainsi, si vous souhaitez ouvrir un fichier en écriture et le créer s'il n'existe pas
encore, vous devez spécifier 5. Notez cependant qu'un fichier ne peut pas être ouvert en lecture et en écriture
en même temps.
commentaires
OPEN ouvre le fichier ASCII spécifié par le nom de fichier, pour le tampon interne indiqué par le descripteur de fichier.
KiXtart prend en charge un maximum de dix fichiers ouverts, le descripteur de fichier doit donc être compris entre
1 et 10.
Retour
3
Descripteur de fichier déjà utilisé
2
1
Nom de fichier spécifié non valide
0
Fichier ouvert avec succès
>0
Erreur système
Exemple SI Ouvert(3, @LDRIVE + "\CONFIG\SETTINGS.INI") =

0 $x = ReadLine(3)
PENDANT @ERREUR = 0
? "Ligne lue : [" + $x + "]"
Machine
Machine Translated
Google
84 KiXtart2010
$x = LireLigne(3)
BOUCLE
FIN SI
LIRE LA LIGNE
Action Lit une ligne d'un fichier.
Syntaxe READLINE (descripteur de fichier)
Paramètre Descripteur de fichier A
expression numérique indiquant le handle du fichier à ouvrir. Les valeurs possibles vont de 1 à 10.
commentaires
READLINE lit une chaîne se terminant par un retour chariot. En cas de succès, la fonction renvoie la chaîne
sans le retour chariot.
Afin d'améliorer les performances de lecture, le premier READLINE sur un fichier lit l'intégralité du fichier en mémoire et
Les commandes READLINE suivantes lisent les lignes de la mémoire.
Retour 4
Fichier non ouvert en lecture
3
Descripteur de fichier non ouvert
2
1 Fin de fichier
0
Ligne lue avec succès
Exemple SI Ouvert(3, @LDRIVE + "\CONFIG\SETTINGS.INI") = 0

$x = LireLigne(3)
PENDANT @ERREUR = 0
? "Ligne lue : [" + $x + "]" $x = ReadLine(3)
BOUCLE
Fermer (3)
AUTRE
BIP
? "Fichier de configuration non ouvert, code d'erreur : [" + @ERROR + "]"
FIN SI
LIRE LA CHAÎNE DE PROFIL
Action
Récupère une chaîne d'un fichier d'initialisation.
Syntaxe READPROFILESTRING("nom du fichier", "section", "clé")

Machine
Machine Translated
Google
KiXtart2010 85

Une chaîne qui nomme le fichier d'initialisation. Si ce paramètre n'inclut pas de chemin complet,
Windows recherche le fichier dans le répertoire Windows.
Section
Une chaîne qui spécifie la section contenant le nom de la clé. Si ce paramètre est vide,
READPROFILESTRING renvoie tous les noms de sections du fichier.
Clé
Une chaîne contenant le nom de la clé dont la chaîne associée doit être récupérée. Si ce paramètre
est vide, tous les noms de clés de la section spécifiée par section sont renvoyés.
commentaires Cette fonction est fournie pour assurer la compatibilité avec les applications Windows 16 bits.
Les applications Win32 stockent les informations d'initialisation dans le registre.
Retour
0 La fonction renvoie une chaîne représentant la valeur de la clé spécifiée
$dev = ReadProfileString("win.ini", "Windows", "Périphérique")

Exemple
READTYPER
Action Renvoie la représentation ASCII d'un type de données d'entrée de registre (par exemple,
REG_SZ).
READTYPE ("sousclé", "entrée")

Syntaxe
Identifie la sousclé contenant l'entrée.
Entrée
Identifiez l'entrée dont vous souhaitez découvrir le type de données.
Retour Représentation ASCII du type de données de l’entrée de registre spécifiée.
Les types de données suivants peuvent être renvoyés :
• REG_NONE
• REG_SZ
• REG_EXPAND_SZ
• REG_BINAIRE
• REG_DWORD
• REG_DWORD_LITTLE_ENDIAN
• REG_DWORD_BIG_ENDIAN
• REG_LINK
• REG_MULTI_SZ
• REG_RESOURCE_LIST
• REG_FULL_RESOURCE_DESCRIPTOR
Machine Translated
86 KiXtart2010
Exemple $RowsType = ReadType("HKEY_CURRENT_USER\Console\Configuration",

"FenêtreRangées")
Si @ERREUR = 0
? "Type de WindowRows : $RowsType"

Fin si
READVALEUR
Action Lit une valeur de registre et la renvoie sous forme de chaîne ASCII.
Syntaxe READVALUE ("sousclé", "entrée")

Identifie la sousclé contenant l'entrée.
Entrée
Identifiez l'entrée dont vous souhaitez découvrir la valeur. Pour lire l'entrée par défaut d'une clé, spécifiez
une chaîne vide comme nom d'entrée ("").
Retour Représentation ASCII de la valeur de registre spécifiée.
Les variables REG_MULTI_SZ (multichaînes) sont renvoyées avec le symbole pipe ( | ) utilisé comme
séparateur entre les chaînes. Si une chaîne contient un caractère de symbole de barre verticale, elle
est représentée par deux caractères de symbole de barre verticale ( || ).
Les variables REG_DWORD sont renvoyées au format décimal.
Exemple $Rows = ReadValue("HKEY_CURRENT_USER\Console\Configuration",

"FenêtreRangées")
Si @ERREUR = 0
? "Nombre de lignes de fenêtres : $Rows"
Fin si
REDIRECTIONNER LA SORTIE
Action Redirige toutes les sorties d'écran vers un fichier.
Syntaxe REDIRECTOUTPUT ("nom de fichier", écraser)

Une chaîne nommant le fichier vers lequel la sortie doit être redirigée. Si ce paramètre est une chaîne
vide (""), la sortie est redirigée vers l'écran. Notez que la sortie peut également être redirigée vers le
périphérique CON ou NUL.
Écraser
Valeur numérique facultative indiquant s'il faut effacer le fichier de sortie avant d'y écrire des données.
Machine
Machine Translated
Google
KiXtart2010 87
0
Nouvelles données de sortie ajoutées au contenu existant du fichier.
1
Toutes les données du fichier sont écrasées lorsque la sortie est redirigée vers le fichier.
commentaires
Si toutes les sorties sont redirigées vers un fichier, les commandes AT, BIG, BOX et CLS sont ignorées.
Retour
0
Sortie redirigée
Exemple SI RedirectOutput("logon.log") = 0 "

? "Ouvert 'logon.log' à + @HEURE ?
FIN SI
REMPLACER
Action
Remplace une ou plusieurs occurrences d'une souschaîne dans une chaîne par une autre chaîne.
Syntaxe REPLACE("stringtoreplacein", "stringtoreplace", "stringtoreplacewith", offset, count)
Paramètres StringToReplaceIn La
chaîne dans laquelle remplacer les chaînes.
StringToReplace
Identifiez la chaîne à remplacer.
StringToReplaceWith Identifiez
la chaîne par laquelle remplacer.
Compenser
Paramètre facultatif indiquant le premier caractère à partir duquel commencer le remplacement des chaînes.
Compter
Facultatif. Nombre de chaînes à remplacer ; 1 indique que toutes les chaînes doivent être remplacées.
Retour
Chaîne dans laquelle toutes les occurrences d'un caractère ou d'une chaîne spécifiée sont remplacées par un autre caractère ou
une autre chaîne spécifiée.
Exemple REPLACE( "chaîne contenant une autre chaîne", "chaîne", "STRING" )

; "STRING contenant un autre STRING"
REPLACE( "chaîne contenant une autre chaîne", "chaîne", "STRING", 1 )

; "STRING avec une autre chaîne dedans"
REPLACE( "chaîne contenant une autre chaîne", "chaîne", "" )

; "avec un autre dedans"
Machine
Machine Translated
Google
88 KiXtart2010
DROITE
Action Renvoie un nombre spécifié de caractères à partir du côté droit d'une chaîne.
DROITE ("chaîne", longueur)

Syntaxe
Paramètres String
Expression de chaîne à partir de laquelle les caractères les plus à droite sont renvoyés.
Longueur
Expression numérique indiquant le nombre de caractères à renvoyer. Si 0, une chaîne de
longueur nulle est renvoyée. S'il est supérieur ou égal au nombre de caractères de la chaîne,
la chaîne entière est renvoyée. Si vous spécifiez une valeur négative, Right renverra le
nombre de caractères égal à la longueur totale de la chaîne moins la valeur
spécifiée.
Retour La souschaîne demandée.
$x = DROITE (@USERID, 2) ; récupère les 2 derniers réservoirs de l'ID utilisateur

Exemple
RND
Action Renvoie un nombre pseudo aléatoire.
RND (plage)
Syntaxe
Paramètre Tidy
Paramètre facultatif indiquant la plage de la valeur de retour (valeur maximale et par défaut
= 32767).
Nombre pseudoaléatoire.
Retour
commentaires La fonction RND renvoie un entier pseudoaléatoire allant de 0 au maximum spécifié. Utilisez la
fonction SRND pour amorcer le générateur de nombres pseudoaléatoires avant d'appeler RND.
$x = RND()
Exemple
$x = RND(10)
ROND
Action Renvoie un nombre arrondi à un nombre spécifié de décimales.
ROND (expression, décimales)

Syntaxe
Machine
Machine Translated
Google
KiXtart2010 89
Decimalplaces
Nombre facultatif indiquant combien de places à droite de la décimale sont incluses dans l'arrondi. En cas d'omission,
Round renvoie un entier.
Retour Nombre arrondi.
RTRIM
Action
Supprime les espaces de fin d'une chaîne d'entrée et renvoie le résultat.
Syntaxe RTRIM ("chaîne")
Paramètre
String
La chaîne à partir de laquelle supprimer les espaces de fin.
Retour
La chaîne d'entrée sans espaces de fin.
Exemple $x = RTRIM(SUBSTR (@IPADDRESS0, 1, 3)); 192
CLÉ DE SAUVEGARDE
Action
Enregistre une clé de registre (y compris ses sousclés et ses entrées de valeur) dans un fichier.
Syntaxe SAVEKEY("sousclé", "nom de fichier")
Identifie la sousclé que vous souhaitez enregistrer.
Nom de fichier
Identifie le fichier dans lequel enregistrer les informations.
commentaires
Lorsque cette fonction s'exécute, le fichier de destination est écrasé sans avertissement.
SAVEKEY nécessite des privilèges de sauvegarde et de restauration.
Retour
0 Sousclé enregistrée
Exemple $ReturnCode = SaveKey("HKEY_CURRENT_USER\EZReg", "c:\temp\tst.reg")

Si $ReturnCode = 0
? « Clé enregistrée . »
Fin si
ENVOYER LES CLÉS
Action
Envoie une ou plusieurs frappes à la fenêtre active comme si elles étaient saisies au clavier.
Machine
Machine Translated
Google
90 KiXtart2010
Syntaxe SENDKEYS ("clés")
Paramètres Keys
Chaîne spécifiant les frappes à envoyer.
Chaque clé est représentée par un ou plusieurs caractères. Pour spécifier un seul caractère du clavier, utilisez le caractère
luimême. Par exemple, pour représenter la lettre A, utilisez « A » pour chaîne. Pour représenter plusieurs caractères,
ajoutez chaque caractère supplémentaire à celui qui le précède. Pour représenter les lettres A, B et C, utilisez « ABC » pour
la chaîne.
Le signe plus (+), le caret (^), le tilde (~), les parenthèses ( ) et l'accolade de départ « { » ont des significations
particulières pour SendKeys. Pour spécifier l'un de ces caractères, placezle entre accolades ({}). Par exemple, pour
spécifier le signe plus, utilisez {+}.
Pour spécifier les caractères qui ne s'affichent pas lorsque vous appuyez sur une touche, telle que ENTRÉE ou TAB, et les
touches qui représentent des actions plutôt que des caractères, utilisez les codes indiqués cidessous :
RETOUR ARRIÈRE
{RETOUR ARRIÈRE}
CASSER
{CASSER}
VERROUILLAGE DES MAJUSCULES

{VERROUILLAGE DES MAJUSCULES}
DE LA {DE LA}
VERS LE BAS
{VERS LE BAS}
FLÈCHE
FIN
{FINIR}
ENTRER
{ENTRER}
ÉCHAP
{ÉCHAP}
AIDE
{AIDE}
MAISON
{MAISON}
INS
{INS}
FLÈCHE GAUCHE
{GAUCHE}
VERROUILLAGE NUMÉRIQUE
{NUMLOCK}
BAS DE PAGE
{PGDN}
PAGE HAUT
{PGUP}
CAPTURE D'ÉCRAN
{PRTSC}
FLÈCHE DROITE {DROITE}

LANGUETTE
{LANGUETTE}
FLÈCHE VERS LE HAUT

{EN HAUT}
F1
{F1}
F2
{F2}
F3
{F3}
F4
{F4}
F5
{F5}
Machine Translated
KiXtart2010 91
F6
{F6}
F7
{F7}
F8
{F8}
F9
{F9}
F10
{F10}
F11
{F11}
F12
{F12}
F13
{F13}
F14
{F14}
F15
{F15}
F 16
{F 16}
Pour spécifier des touches combinées avec n'importe quelle combinaison des touches SHIFT, CTRL et ALT,
faites précéder le code de la clé par un ou plusieurs des codes suivants :
CHANGEMENT
+
^
CTRL
~
ALT
Pour spécifier que toute combinaison de MAJ, CTRL et ALT doit être maintenue enfoncée pendant que plusieurs
autres touches sont enfoncées, placez le code de ces touches entre parenthèses.
Par exemple, pour spécifier de maintenir la touche MAJ enfoncée pendant que E et C sont enfoncés, utilisez "+(EC)".
Pour spécifier de maintenir SHIFT enfoncé pendant que E est enfoncé, suivi de C sans SHIFT, utilisez
"+EC".
Pour spécifier des clés répétitives, utilisez le formulaire {numéro de clé}. Vous devez mettre un espace entre la clé
et le numéro. Par exemple, {LEFT 42} signifie appuyer 42 fois sur la touche FLÈCHE GAUCHE ; {h 10} signifie
appuyer 10 fois sur H.
commentaires SendKeys ne peut pas être utilisé pour envoyer des frappes au clavier à une application qui n'est pas conçue pour
s'exécuter sous Microsoft Windows. Les Sendkeys ne peuvent pas non plus envoyer la touche PRINT SCREEN
{PRTSC} à une application.
Retour
0
Les frappes se sentent
Exemple Exécuter("Notepad.exe")
Dormir 1
SetFocus( "Sans titre – Blocnotes" )
$ReturnCode = SendKeys("Bonjour tout le monde")
Dormir(2)
$ReturnCode = SendKeys("~{F4}Y")
Machine Translated
92 KiXtart2010
ENVOYER LE MESSAGE
Action Envoie un message sur le réseau à un autre utilisateur ou poste de travail.

]
Syntaxe ENVOYER UN MESSAGE (« destinataire », « message »)
Paramètres Récipient
Identifiez l'utilisateur ou le poste de travail auquel envoyer le message.
Message Le
message à envoyer.
Retour
0
Message envoyé
"
$ReturnCode = SendMessage("ADMIN" , @USERID + " connecté à + @TEMPS)
Exemple
Si $ReturnCode = 0
? "Le message a été envoyé.."
Fin si
SETASCII
Action Active/désactive la sortie de la console ASCII. Dans KiXtart, la sortie standard de la console est en Unicode
et SetASCII vous permet de la changer en ASCII, afin que vous puissiez sortir des caractères étendus, tels
que des caractères de ligne.
Syntaxe SETASCII("mode")
Paramètres Mode
Chaîne qui spécifie s'il faut activer ou désactiver la sortie ASCII. Spécifier « ON » activera la sortie ASCII et
spécifier « OFF » désactivera la sortie ASCII.
Retour
« ON » | "DÉSACTIVÉ" État de sortie précédent.
Exemple $étatprécédent = SetASCII( "ON" )
? «ÿÿÿÿÿÿÿÿÿÿÿ» ; afficher les caractères de ligne ASCII
DéfinirASCII($état précédent)
commentaires SETASCII n'est pris en charge que pour des raisons de compatibilité ascendante. Les nouveaux scripts doivent
utiliser la fonction SETOPTION.
Machine
Machine Translated
Google
KiXtart2010 93
RÉGLAGECONSOLE
Action
Modifie l'état d'affichage de la fenêtre d'invite de commande dans laquelle KiXtart est exécuté.
Syntaxe SETCONSOLE("mode")
Paramètres Mode
Chaîne qui spécifie le nouvel état d'affichage. Le tableau suivant présente les états d'affichage pris en charge par cette
fonction.
MONTRER Afficher la fenêtre
CACHER Masquer la fenêtre
PREMIER PLAN
Déplacer la fenêtre au premier plan
TOUJOURS AU TOP
Amener la fenêtre en haut
MINIMISER Réduire la fenêtre
MAXIMISER Agrandir la fenêtre
commentaires
Si une fenêtre est masquée, elle ne disparaît pas du système mais reste active.
Retour
0
L'état d'affichage a changé
Exemple Si SetConsole("FOREGROUND") = 0
? "La console a été déplacée au premier plan..."
Fin si
DÉFINIR IMPRIMANTE PAR DÉFAUT
Action
Définit l'imprimante par défaut à laquelle les applications envoient les travaux d'impression.
Syntaxe SETDEFAULTPRINTER ("nom de l'imprimante")
Paramètres Nom de l'imprimante
Chaîne qui spécifie le nom complet de l'imprimante à définir comme imprimante par défaut.
Notez que si l'imprimante impliquée était connectée à l'aide de
AddPrinterConnection, vous devez inclure à la fois le nom du serveur et l'imprimante.

nom.
Retour
0
Ensemble d'imprimante par défaut
Exemple
Machine
Machine Translated
Google
94 KiXtart2010
Si AddPrinterConnection ("\\vleerbeer\hp laserjet 4") = 0
? « Connexion d'imprimante ajoutée. »
Si SetDefaultPrinter ("\\vleerbeer\hp laserjet 4") = 0
? "Définir l'imprimante par défaut sur HP LaserJet 4...."

Fin si
Fin si
SETFILEATTR
Action Définit les attributs d'un fichier.
Syntaxe SETFILEATTR ("nom de fichier", attributs)

Identifiez le fichier dont vous souhaitez définir les attributs.

Les attributs
Attributs à définir pour le fichier. Les attributs peuvent avoir une ou plusieurs des valeurs
suivantes :
1 Lecture seulement
Le fichier ou le répertoire est en lecture seule. Les applications peuvent lire le
fichier mais ne peuvent pas y écrire ni le supprimer. Dans le cas d'un répertoire, les
applications ne peuvent pas le supprimer.
2 Caché
Le fichier ou le répertoire est masqué. Il n'est pas inclus dans une liste d'annuaire
ordinaire.
4
Système Le fichier ou le répertoire fait partie du système d'exploitation ou est utilisé
exclusivement par celuici.
32 Archive
Le fichier ou le répertoire est un fichier ou un répertoire d'archive.
Les applications utilisent cet attribut pour marquer les fichiers à sauvegarder ou
à supprimer.
128 Normale
Le fichier ou le répertoire n'a aucun autre attribut défini. Cet attribut n'est valide que
s'il est utilisé seul.
256 Temporaire Le fichier est utilisé pour le stockage temporaire. Les systèmes de fichiers
tentent de conserver toutes les données en mémoire pour un accès plus rapide
plutôt que de les renvoyer vers le stockage de masse. Un fichier
temporaire doit être supprimé par l'application dès qu'il n'est plus nécessaire.
4096 Hors ligne

Les données du fichier ne sont pas immédiatement disponibles. Indique que les
données du fichier ont été physiquement déplacées vers un stockage hors ligne.
Retour 0 Ensemble d'attributs
Exemple $Result = SetFileAttr (@LDRIVE + "\Kix32.exe", 32)

Machine Translated
KiXtart2010 95
RÉGLERFOCUS
Action
Définit le focus d’entrée sur l’application spécifiée. Cette fonction est très utile en combinaison avec la fonction SendKeys.
Syntaxe SETFOCUS ("Titre")
Paramètres Titre
Chaîne spécifiant le titre dans la barre de titre de la fenêtre de l'application que vous souhaitez activer. Pour déterminer quelle
application activer, le titre est comparé à la chaîne de titre de chaque application en cours d'exécution. S'il n'y a pas de correspondance
exacte, toute application dont la chaîne de titre commence par title est activée. S'il existe plusieurs instances de l'application
nommées par leur titre, une instance est activée arbitrairement.
Retour
0
Focus défini sur l’application spécifiée.
Exemple Si SetFocus("Sans titre Blocnotes") = 0
? « Concentration sur le Blocnotes… »

Fin si
OPTION DE RÉGLAGE
Action
SetOption peut être utilisé pour configurer certaines options du moteur de script KiXtart.
Syntaxe SETOPTION("option", "valeur")
Paramètres Option
Option à définir.
Valeur
Valeur de l'option.
Les options et valeurs possibles sont décrites dans le tableau suivant :
ASCII NOUS, La sortie par défaut de la console est en Unicode. La définition de l'option ASCII
DÉSACTIVÉ
sur ON modifie la sortie en ASCII, afin que vous puissiez sortir des caractères
étendus, tels que des caractères de ligne.
Sensibilité à la casse NOUS, Par défaut, toutes les comparaisons de chaînes ne sont pas sensibles à la casse.
DÉSACTIVÉ
La définition de l’option CaseSensitivity sur ON configure KiXtart pour que
les comparaisons de chaînes soient sensibles à la casse.
NOUS
Désactiver le débogage Désactive le débogage (désactive effectivement la commande DEBUG ON). Notez
g que le débogage ne peut pas être réactivé.
Explicite NOUS, Lorsque vous activez l'option Explicite, vous devez déclarer explicitement toutes les
DÉSACTIVÉ
variables à l'aide de Dim, Global ou ReDim.
Machine Translated
96 KiXtart2010
déclarations. Si vous essayez d'utiliser une variable non déclarée

nom, une erreur se produit.
Utilisez l'option Explicite pour éviter de saisir incorrectement le nom d'une
variable existante.
MasquerCurseur NOUS,
Masque ou affiche le curseur de la console.
DÉSACTIVÉ
NoMacrosInStrin NOUS, Détermine la résolution des macros à l’intérieur des chaînes. Si cette option est
DÉSACTIVÉ
gs activée, tout caractère '@' dans une chaîne sera laissé tel quel. La valeur par défaut est
DÉSACTIVÉE.
NoVarsInStrings activé, Détermine la résolution des variables à l’intérieur des chaînes. Si cette option est
DÉSACTIVÉ
activée, tout caractère '$' dans une chaîne sera laissé tel quel. La valeur par défaut est
DÉSACTIVÉE.
Action Wow64FileResay NOUS,

Active/désactive la redirection de fichiers sur les éditions 64 bits de
DÉSACTIVÉ Les fenêtres. Voir cet article MSDN pour plus de détails à ce sujet
fonctionnalité. La valeur par défaut est ON.
Cette option n'a aucun effet sur les éditions 32 bits de Windows.
WOW64Alternatif NOUS, Permet d'accéder à la vue alternative du registre. Consultez cet article MSDN pour
DÉSACTIVÉ plus de détails sur cette fonctionnalité. La valeur par défaut est DÉSACTIVÉE.
RegView
Cette option n'a aucun effet sur les éditions 32 bits de Windows.
WrapAtEOL NOUS, Active/désactive le retour à la ligne de la sortie de la console à la fin d'une ligne. La valeur
DÉSACTIVÉ par défaut est DÉSACTIVÉE.
Retour
SetOption renvoie l'état précédent de l'option.
Exemple $étatprécédent = SetOption( "ASCII", "ON" )
? «ÿÿÿÿÿÿÿÿÿÿÿ» ; afficher les caractères de ligne ASCII
$état précédent = SetOption( "ASCII", $état précédent )
DÉFINIR L'ÉTAT DU SYSTÈME
Action
Modifie l'état (d'alimentation) de l'ordinateur.
Syntaxe SETYSTEMSTATE (mode, force)
Paramètres Mode
Paramètre facultatif spécifiant l'un des modes suivants :
Valeur Action
0
Système de verrouillage (pris en charge sous Windows 2000 ou supérieur uniquement).
1
Attendre.
Machine Translated
KiXtart2010 97
2 Hiberner.
3 Éteindre.
Force
Spécifie si les applications comportant des modifications non enregistrées sont fermées de force. Si la force n’est
pas nulle, les candidatures sont fermées. Si la force est nulle, une boîte de dialogue s'affiche invitant l'utilisateur à
fermer les applications.
Retour
0 Action réussie
Action: échoué
Code d'erreur système
Exemple $RC = Définir l'état du système (1 , 1) ; Forcer le système à passer en mode veille
RÉGLER LE TITRE
Action Définit le titre de la console actuelle.
Syntaxe RÉGLAGE DU TITRE("titre")
Paramètres Titre
Chaîne qui sera utilisée comme nouveau titre pour la console actuelle.
commentaires Le titre n'est actif que pendant l'exécution de KiXtart. Dès la sortie de KiXtart, le titre original de la console sera
restauré.
Retour
0 Ensemble de titres
Exemple Si SetTitle("Connexion KiXtart") = 0

? "Définissez le nouveau titre..."
Fin si
DÉFINIR LE PAPIER PEINT
Action Définit le fond d'écran actuel.
Syntaxe SETWALLPAPER("nom du fond d'écran", mode)
Paramètres Nom du fond

d'écran Chaîne qui spécifie le nom du bitmap à définir comme fond d'écran par défaut.
Mode
Paramètre facultatif spécifiant l'un des modes suivants :
Valeur Action
0
Changez le fond d'écran uniquement pour la durée de la session de connexion en cours.
Machine Translated
98 KiXtart2010
1
Modifie le fond d'écran dans le profil utilisateur.
commentaires Le fichier spécifié doit être un fichier BMP valide.

Retour
0
Ensemble de papier peint
Exemple Si SetWallpaper("kixtart.bmp") = 0 ?
"Définir le fond d'écran actuel sur KiXtart.bmp...."
Fin si
AFFICHERGROUPEPROGRAMME
Action Instructions au gestionnaire de programme pour minimiser, maximiser ou restaurer la fenêtre d'un fichier existant.
groupe de programmes.
Syntaxe SHOWPROGRAMGROUP ("nom du groupe", commande show, indicateur de groupe commun)
Paramètres Nom du groupe

Identifie la fenêtre de groupe à réduire, agrandir ou restaurer.
Afficher la commande
Spécifie l'action que Program Manager doit effectuer sur la fenêtre de groupe. Ce paramètre est un entier et il doit avoir
l'une des valeurs suivantes.
Valeur Action
1
Active et affiche la fenêtre de groupe. Si la fenêtre est réduite ou agrandie, Windows la
restaure à sa taille et sa position d'origine.
2
Active la fenêtre de groupe et l'affiche sous forme d'icône.
3
Active la fenêtre de groupe et l'affiche sous forme de fenêtre agrandie.
4
Affiche la fenêtre de groupe dans sa taille et sa position les plus récentes. La fenêtre
active reste active.
5
Active la fenêtre de groupe et l'affiche dans sa taille et sa position actuelles.
6
Réduit la fenêtre du groupe.
7
Affiche la fenêtre de groupe sous forme d'icône. La fenêtre active reste
actif.
8
Affiche la fenêtre de groupe dans son état actuel. La fenêtre active reste active.
0
Agit sur un groupe personnel.
1
Agit sur un groupe commun. Pour manipuler un groupe commun, l'utilisateur doit
Machine
Machine Translated
Google
KiXtart2010 99
avez des privilèges administratifs, ou la fonction échoue.
Retour
0
Groupe de programmes maximisé, réduit ou restauré
Exemple Si ShowProgramGroup("NewGroup", 6, 0) =
0 ? "NewGroup a été minimisé...."
Fin si
FERMER
Action Arrête ou redémarre un ordinateur.
Syntaxe SHUTDOWN ("ordinateur", "message", attendre, forcer, options)
Paramètres Ordinateur
Nom de l'ordinateur qui doit être arrêté ou redémarré. Une chaîne vide ("") indique l'ordinateur local.
Chaîne de
message qui spécifie un message à afficher dans la boîte de dialogue Arrêt.
Attendez
Paramètre facultatif spécifiant la durée en secondes d'affichage de la boîte de dialogue.

Pendant que la boîte de dialogue est affichée, l'arrêt du système peut être arrêté à l'aide de la fonction Win32
AbortSystemShutdown.
Si l'attente n'est pas nulle, SHUTDOWN affiche une boîte de dialogue sur l'ordinateur spécifié.
La boîte de dialogue, qui affiche le nom de l'utilisateur qui a appelé la fonction et le message spécifié par
message, invite l'utilisateur à se déconnecter. Le système émet un bip lorsque la boîte de dialogue est créée.
La boîte de dialogue reste audessus des autres fenêtres et peut être déplacée mais pas fermée.
Une minuterie compte à rebours le temps restant avant un arrêt forcé. Si l'utilisateur se déconnecte, le système s'arrête
immédiatement. Sinon, l'ordinateur s'éteint à l'expiration du délai.
Si l'attente est nulle, l'ordinateur s'arrête sans afficher la boîte de dialogue et l'arrêt ne peut pas être arrêté par
AbortSystemShutdown.
Force
Spécifie si les applications comportant des modifications non enregistrées sont fermées de force. Si la force n’est pas
nulle, les candidatures sont fermées. Si la force est nulle, une boîte de dialogue s'affiche invitant l'utilisateur à
fermer les applications.
Options
Paramètre facultatif spécifiant l'une des options suivantes.
Valeur Action
1
Redémarrez l'ordinateur après l'arrêt.
Machine Translated
100 KiXtart2010
2
Éteignez le système après l'arrêt (NB : cette option ne fonctionne que pour le système local).
Retour
0
Ordinateur éteint
La fonction a échoué
Code d'erreur système
Exemple $RC = Shutdown("", "Le système est en cours de redémarrage pour activer les nouveaux paramètres.", 60, 0, 1)
SIDTONOM
Action Traduit un identifiant de sécurité (SID) en un nom.
Syntaxe SIDTONAME (« sid »)

Paramètre SID
Représentation sous forme de chaîne du SID à traduire.
Retour
0
Nom correspondant au SID.
Exemple ? SidVersNom("S110"); affiche « Tout le monde »
Si DansGroupe(SidToName("S1532544"))
? "Doit signifier que l'utilisateur actuel est membre des administrateurs locaux"
Fin si
DIVISER
Action
Renvoie un tableau unidimensionnel de base zéro contenant un nombre spécifié de souschaînes.
Syntaxe SPLIT("chaîne", "délimiteur", nombre)

Paramètre
Chaîne
Obligatoire. Expression de chaîne contenant des souschaînes et des délimiteurs. Si expression est une chaîne de
longueur nulle, Split renvoie un tableau vide, c'estàdire un tableau sans éléments ni données.
Délimitation
Facultatif. Caractère(s) de chaîne utilisé(s) pour identifier les limites des souschaînes. S'il est omis, le
caractère espace (" ") est considéré comme le délimiteur. Si le délimiteur est une chaîne de longueur nulle, un
tableau d'éléments uniques contenant la chaîne d'expression entière est renvoyé.
Compter
Facultatif. Nombre de souschaînes à renvoyer ; 1 indique que toutes les souschaînes sont renvoyées.
Machine Translated
KiXtart2010 101
Retour Un tableau contenant les souschaînes trouvées dans la chaîne d'entrée.
Exemple $Monarray = Split("aaa~~bbb~~ccc", "~~")
Pour chaque $Element dans

$MyArray ? $Élément ; affichera "aaa", "bbb" et "ccc"
Suivant
SRND
Action
La fonction SRND définit le point de départ pour générer une série d'entiers pseudoaléatoires.
Pour réinitialiser le générateur, utilisez 1 comme argument de départ. Toute autre valeur de départ définit le générateur sur un
point de départ aléatoire. RND récupère les nombres pseudoaléatoires générés.
L'appel de RND avant tout appel à SRND génère la même séquence que l'appel de SRND avec la graine passée à 1.
Syntaxe SRND (graine)
Paramètre graine
Valeur numérique avec laquelle amorcer le générateur.
Retour Rien.
Exemple SRND( @MSECS )
SUBSTR
Action
Renvoie une partie d'une chaîne.
Syntaxe SUBSTR("chaîne", début, longueur)
Paramètres String
La chaîne à partir de laquelle extraire une souschaîne.
Commencer
Valeur numérique représentant le décalage dans la chaîne où commence la souschaîne.
Longueur
Valeur numérique facultative représentant la longueur de la souschaîne. En cas d'omission ou s'il y a moins de
caractères de longueur dans le texte (y compris le caractère de début), tous les caractères de la position de début à la fin
de la chaîne sont renvoyés.
Retour La souschaîne indiquée par le début et la longueur.
Exemple $x = SUBSTR (@USERID, LEN (@USERID) 1, 2) l'identifiant ; récupérez les 2 derniers réservoirs de
de l'utilisateur
Machine
Machine Translated
Google
102 KiXtart2010
GARNITURE
Action Supprime les espaces de début et de fin d’une chaîne d’entrée et renvoie le résultat.
Syntaxe TRIM ("chaîne")

Paramètre String
La chaîne à partir de laquelle supprimer les espaces.
Retour La chaîne d'entrée sans espaces de début et de fin.
Exemple $x = TRIM(SUBSTR (@IPADDRESS0, 1, 3))
UBOUND
Action Renvoie le plus grand indice disponible pour l'une des dimensions d'un tableau.
Syntaxe UBOUND (tableau, dimension)

Paramètre Array
Le tableau dont vous souhaitez connaître la limite supérieure.
Dimension
Paramètre facultatif indiquant la dimension du tableau dont vous souhaitez connaître la limite
supérieure. La valeur par défaut est 1.
Retour
1
La dimension du tableau ne contient aucun élément.
>= 0
Le plus grand indice disponible pour la dimension indiquée du tableau.
Exemple $x = UBOUND($MonTableau)
UCASE
Action Renvoie une chaîne en majuscule.
Syntaxe UCASE("chaîne")
Paramètre Chaîne
La chaîne que vous souhaitez mettre en majuscule.
Retour La chaîne d'entrée en majuscule.
$x = UCASE (@USERID)
Exemple
Machine Translated
KiXtart2010 103
DÉCHARGEMENT
Action Décharge la clé et les sousclés spécifiées du registre.
Syntaxe DÉCHARGER ("clé")
Paramètres Clé
La clé que vous souhaitez décharger. Cette clé doit avoir été créée à l'aide de LoadHive.
commentaires Sous Windows NT, l'utilisation de UNLOADHIVE nécessite des privilèges de sauvegarde et de restauration.
Retour
0
Clé chargée
Exemple $ReturnCode = UnLoadHive( "HKEY_USERS\Fiets" )
Si $ReturnCode = 0
? "Ruche déchargée..."
Fin si
VAL
Action Renvoie la valeur numérique d'une chaîne.
Syntaxe VAL ("chaîne")

Paramètre
String
La chaîne dont vous souhaitez découvrir la valeur numérique. Par défaut, Val s'attend à ce que la chaîne soit au format
décimal. Pour déterminer la valeur numérique d'une chaîne hexadécimale, commencez la chaîne par une
esperluette « & ».
Retour
La valeur numérique de la chaîne d'entrée.
Exemples $x = VAL(SUBSTR(@IPADDRESS0, 1, 3)) $x

= VAL("&A34")
TYPE VART
Action Renvoie une valeur entière indiquant le soustype d'une variable.
Syntaxe VARTYPE($variable)
Paramètres Variable
Tout type de variable.
Retour
Machine
Machine Translated
Google
104 KiXtart2010
0
Vide
1
Null (aucune donnée valide)
2
Entier
3 Entier long
4
Nombre à virgule flottante simple précision
5
Nombre à virgule flottante double précision
6
Devise
7 Date
8
Chaîne
9
Poignée d'objet
dix Erreur
11 Booléen
12
Variante (utilisé uniquement avec des tableaux de variantes)
13
Un objet d'accès aux données
17 Octets
8192
Tableau (ne peut apparaître qu'en combinaison avec l'une des autres valeurs)
Exemple $MaVar = "AnyData"

? VarType($MaVar) ; affichera "8" (chaîne)
$MonTableau = "a", "b", "c"

? VarType($MonTableau) ; affichera "8204" (Tableau de
? VarType($MonTableau[0]) variantes) ; affichera "8" (chaîne)
NOMTYPEVART
Action
Renvoie une chaîne qui fournit des informations de type sur une variable.
Syntaxe VARTYPENAME ($ variable)
Paramètres Variable
Tout type de variable.
Retour Octets Valeur d'octet
Réservoir
Valeur d'un seul caractère
Entier Valeur entière
Long Valeur entière longue
Célibataire Valeur à virgule flottante simple précision

Double
Valeur à virgule flottante double précision
Devise Valeur monétaire

Machine
Machine Translated
Google
KiXtart2010 105
Décimal Valeur décimale
Date Valeur de date ou d'heure
Chaîne Valeur de la chaîne de caractères
Booléen Valeur booléenne ; Vrai ou faux
Unitialisé
Vide
Nul Aucune donnée valide
Objet Objet générique

Inconnu
Type d'objet inconnu
Rien Variable d'objet qui ne fait pas encore référence à une instance d'objet
Erreur Erreur
[] Tableau (ne peut apparaître qu'en combinaison avec l'une des autres valeurs)
Exemple ? VarTypeName("KiXtart") ; Affiche « Chaîne ».

? NomTypeVar(4) ; Affichages « longs ».
? NomTypeVar(37.50) ; Affichages « doubles ».
? VarTypeName($ArrayVar) ; Affiche « Variante[] ».
ÉCRIRE LIGNE
Action
Ajouter une ligne à la fin d'un fichier. Si WriteLine rencontre une erreur, @ERROR est défini sur le code d'erreur approprié.
Syntaxe WRITELINE (descripteur de fichier, "linetowrite")
Paramètre Descripteur de fichier
Expression numérique indiquant le descripteur du fichier auquel ajouter. Plage de valeurs possibles
de 1 à 10.
LigneVersEcrire
La chaîne que vous souhaitez écrire dans le fichier.
commentaires
WriteLine n'ajoute pas automatiquement un <Carriage Return>, donc si vous souhaitez écrire un <Carriage Return>, vous
devez l'ajouter à la chaîne (comme dans : $LineToWrite + @CRLF).
Retour 4
Fichier non ouvert en écriture
3
Descripteur de fichier non ouvert
2
1 Fin de fichier
0
Ligne écrite avec succès
SI Ouvert( 3 $x , "C:\TEMP\LOG.TXT" , 5)=0 "

Exemple
= ÉcrireLigne( 3 , "KiXtart a commencé à + @TIME + @CRLF
AUTRE
Machine
106 KiXtart2010
BIP
? "Échec de l'ouverture du fichier, code d'erreur : [" + @ERROR + "]"

FIN SI
ÉCRIRE UNE CHAÎNE DE PROFIL
Action
Copie une chaîne dans un fichier d'initialisation.
Syntaxe WRITEPROFILESTRING("nom de fichier", "section", "clé", "chaîne")
Chaîne identifiant le fichier d'initialisation. Si ce paramètre n'inclut pas de chemin complet, Windows recherche
le fichier dans le répertoire Windows.
Section
Chaîne contenant le nom de la section du fichier d'initialisation où la chaîne est copiée. Si la section n'existe pas, elle
est créée. Le nom de la section n'est pas sensible à la casse et peut contenir n'importe quelle combinaison de lettres
majuscules et minuscules.
Clé
Chaîne contenant le nom de la clé à associer à la chaîne. Si la clé n'existe pas dans la section spécifiée, elle est créée.
Si ce paramètre est vide, la section entière, y compris toutes les entrées de la section, est supprimée.
String
Chaîne à écrire dans le fichier. Si ce paramètre est vide, la clé identifiée par key est supprimée.
commentaires
Cette fonction est fournie pour la compatibilité avec les applications Windows 16 bits.
Les applications Win32 stockent les informations d'initialisation dans le registre.
Retour
0
Chaîne de profil écrite
VALEUR D'ÉCRITURE
Action
Crée une nouvelle clé, ajoute un autre nom de valeur à une clé existante (et lui attribue une valeur) ou modifie la valeur
d'un nom de valeur existant.
Syntaxe WRITEVALUE("sousclé", "entrée", "expression", "type de données")
Identifiez la sousclé dans laquelle vous souhaitez écrire une entrée de valeur.
Machine Translated
KiXtart2010 107
Entrée
Le nom de l'entrée. Pour écrire dans l'entrée par défaut d'une clé, spécifiez une chaîne vide comme nom
d'entrée ("").
Expression
Les données à stocker comme valeur de l'entrée.
Les variables REG_MULTI_SZ (multichaînes) sont renvoyées avec le symbole pipe ( | ) utilisé comme séparateur
entre les chaînes. Si une chaîne contient un caractère de symbole de barre verticale, elle est représentée
par deux caractères de symbole de barre verticale ( || ).
Type de
données Identifie le type de données de l'entrée.
Les types de données suivants sont pris en charge :
• REG_NONE •
REG_SZ •
REG_EXPAND_SZ •
REG_BINAIRE •
REG_DWORD •
REG_DWORD_LITTLE_ENDIAN •
REG_DWORD_BIG_ENDIAN •
REG_LINK •
REG_MULTI_SZ •
REG_RESOURCE_LIST •
REG_FULL_RESOURCE_DESCRIPTOR
Retour 0
Entrée de valeur écrite
Exemple WriteValue("EZReg\Test", "Une variable MultiString", "Ligne 1|Ligne 2|Ligne 3 avec un || dedans|", "REG_MULTI_SZ")
Si @ERREUR = 0
? "Valeur écrite dans le registre"
Fin si
Machine Translated
108 KiXtart2010
Référence des macros KiXtart
Les macros peuvent être utilisées partout où une expression est attendue. Les macros prises en charge sont définies dans le tableau suivant.
Macro Définition
@ADRESSE Adresse de la carte réseau
@CONSTRUIRE Numéro de build du système d'exploitation
@COULEUR Paramètre de couleur actuel de la console

Commentaire de l'utilisateur
@COMMENT
@CPU Nom du CPU (ex : "Intel Pentium III").
@CRLF Retour chariot + Saut de ligne
@CSD Informations CSD (par exemple : "Service Pack 1")
@CURDIR Répertoire actuel
@DATE Date (au format AAAA/MM/JJ)
@JOUR Jour de la semaine (lundi, mardi, etc.)
@DOMAINE Domaine ou groupe de travail auquel appartient l'ordinateur

Version Windows
@DOS
Code retour de la commande ou de la fonction la plus récente. Un code retour de 0 signifie
@ERREUR
la commande ou la fonction a réussi. Toute autre valeur indique une erreur.
Nom complet de l'utilisateur actuel
@NOM ET PRÉNOM
@HOMEDIR Nom court de la partie répertoire du répertoire personnel
@HOMEDRIVE* Lettre de lecteur du lecteur contenant le répertoire personnel
@HOMESHR Le serveur et le nom de partage font partie du répertoire personnel
@NOMHOST Nom d'hôte TCP/IP complet (y compris le nom de domaine TCP/IP)
@INWIN Système d'exploitation : 1 = Windows NT ; 2 = Windows 9x
@IPADDRESSx Adresse TCP/IP (les valeurs possibles pour x sont 0 à 3).

Remarque Les adresses sont complétées de sorte que la chaîne résultante soit toujours composée de
quatre ensembles de trois caractères séparés par des points. Par exemple, si votre adresse IP est
123.45.6.7, @IPADDRESS0 est 123. 45. 6. 7.
@KIX Nom et version du produit KiXtart
@LANROOT Répertoire où réside le logiciel réseau (généralement Systemroot\System32)
@LDOMAIN* Domaine de connexion
@LDRIVE Lecteur redirigé vers \\logonserver\NETLOGON

Version du logiciel réseau
@LM
@LOGONMODE Si 1, indique que KiXtart suppose être en cours d'exécution pendant la séquence de connexion
@LONGHOMEDIR Nom long de la partie répertoire du répertoire personnel
@LSERVER Serveur de connexion
@MAXPWAGE Âge maximum du mot de passe

Machine
KiXtart2010 109
@MDAYNO Jour du mois (131)
@MHZ Approximation de la vitesse du processeur.
@MOISNO Mois depuis janvier (112)

Nom du mois
@MOIS
@MSECS Millisecondes faisant partie de l'heure actuelle
@ONWOW64 Si cette macro renvoie 1, KiXtart s'exécute dans l'environnement WOW64 sur un système Windows x64.
@PID ID de processus du processus KiXtart
@PRIMARYGROUP* Groupe principal de l'utilisateur actuel
@PRIV Niveau de privilège de l'utilisateur (INVITÉ, UTILISATEUR, ADMIN)
@PRODUCTSUITE Le système d'exploitation a continué. Combinaison de l'une des valeurs suivantes :
1 "Petite entreprise"
2
"Entreprise"
4 « BackOffice »
8 « Serveur de communication »
16 « Terminal Serveur »
32 « Petites entreprises (restreint) »
64 « EmbeddedNT »
128 « Centre de données »
256 "Serveur Terminal Server monoutilisateur"
512 "Édition familiale"
1024 "Serveur Blade"
2048 "Intégré (restreint)"
4096 "Appareil de sécurité"
8192 "Serveur de stockage"
16384 « Serveur de cluster de calcul »
32768 « Serveur domestique »
@TYPE DE PRODUIT Système d'exploitation typique. Valeurs possibles:
"Windows 2000 Professionnel"
"Windows 2000 Serveur"
"Contrôleur de domaine Windows 2000"
"Windows XP Édition Familiale"
"Windows XP Professionnel"
"Tablette PC Windows XP Professionnel"
"Windows XP Édition Media Center"
"Windows XP Édition Démarreur"

Machine Translated
110 KiXtart2010
« Principes de base de Windows pour les anciens PC »
"Windows Serveur 2003"
"Contrôleur de domaine Windows Server 2003"
"Windows Serveur 2003 R2"
"Contrôleur de domaine Windows Server 2003 R2"
"Windows Vista Édition Démarreur"
"Windows Vista Édition Familiale Basique (N)"

"Windows Vista Édition Familiale Premium"
"Windows Vista Édition Professionnelle (N)"
"Windows Vista Édition Entreprise"

"Windows Vista Édition Intégrale"
"Windows Serveur 2008 (R2)"
"Windows Server 2008 (R2) Noyau"
"Windows Server 2008 (R2) Édition Petite Entreprise"
"Windows Server 2008 (R2) Édition Entreprise"
"Windows Server 2008 (R2) Édition Entreprise Core"
"Windows Server 2008 (R2) Édition Centre de Données"
"Windows Server 2008 (R2) Édition Centre de Données Core"
"Windows Server 2008 (R2) Édition Entreprise pour Itanium"
"Windows Server 2008 (R2) Édition Serveur Web"
"Windows Server 2008 (R2) Édition Serveur Web Core"
"Windows Server 2008 (R2) Édition Cluster de calcul"
"Windows Server 2008 (R2) Édition Familiale"
"Windows Storage Server 2008 (R2) Édition Express"
"Windows Storage Server 2008 (R2) Édition Standard"
"Windows Storage Server 2008 (R2) Édition Entreprise"
"Windows Storage Server 2008 (R2) Édition Petite Entreprise"
« Serveur d'entreprise essentiel Windows Server 2008 (R2) »
"Windows Server 2008 (R2) Essential Business Server Premium"
"Gestion des serveurs d'entreprise essentiels Windows Server 2008 (R2)"
« Messagerie professionnelle essentielle Windows Server 2008 (R2) »
« Sécurité professionnelle essentielle de Windows Server 2008 (R2) »
"Windows Server 2008 (R2) HyperV"

Machine Translated
KiXtart2010 111
"Fondation Windows Server 2008 (R2)"
"Windows 7 Édition Démarreur (N)"
"Windows 7 Édition Familiale Basique (N)"
« Windows 7 Édition Familiale Premium (N) »
"Windows 7 Édition Professionnelle (N)"
"Windows 7 Édition Professionnelle (N)"
« Windows 7 Édition Entreprise (N) »
"Windows 7 Édition Intégrale (N)"
"Windows 8(.1) (N)"
"Windows 8 (.1) Édition Professionnelle (N)"
"Windows 8 (.1) Édition Entreprise (N)"
"Windows Serveur 2012 (R2)"
« Fondation Windows Server 2012 (R2) »
"L'essentiel de Windows Server 2012 (R2)"
"Centre de données Windows Server 2012 (R2)"
« Windows 10 Famille (N) »
« Windows 10 Professionnel (N) »
« Windows 10 Entreprise (N) »
@PROGRAMFILESX86
@PWAGE Âge du mot de passe
@RAS Nombre de connexions actives au service d'accès à distance (RAS)
@RÉSULTAT Renvoie des informations spécifiques à la commande (par exemple : la lettre de lecteur d'une
commande de redirection automatique)
Serveur KXRPC utilisé pour la session en cours
@RSERVEUR*
@SCRIPTDIR Répertoire du script actuel
@SCRIPTEXE Nom de l'exécutable KiXtart ("KIX32.EXE", "WKIX32.EXE")
@SCRIPTNAME Nom du script actuel
@SERREUR Texte d'erreur correspondant à @ERROR
@SID* Identifiant de sécurité Windows (SID) de l'utilisateur actuel
@SITE** Nom du site sur lequel réside le système
@STARTDIR Répertoire à partir duquel KiXtart a été démarré
@SYSLANG Nom anglais complet de la langue du système d'exploitation spécifié dans le format
Machine
Machine Translated
Google
112 KiXtart2010
défini par la norme ISO 639. (exemple : "0413Dutch (Standard)").
@TICQUES Renvoie le nombre de millisecondes écoulées depuis le démarrage du système.
@TEMPS Heure actuelle (au format HH:MM:SS)
@TSSESSION Si cette macro renvoie 1, KiXtart s'exécute dans une session Terminal Server.
ID utilisateur Windows de l'utilisateur actuel
@ID DE L'UTILISATEUR
@USERLANG Nom anglais complet de la langue sélectionnée par l'utilisateur actuel spécifié dans le format défini par la
norme ISO 639. (exemple : "0413Dutch (Standard)").
@WDAYNO Jours depuis dimanche (1–7)
@WKSTA Nom de l'ordinateur

ID utilisateur Windows de l'utilisateur actuel
@WUSERID
@YDAYNO Jours depuis le 1er janvier (1–365)
@ANNÉE Année actuelle
Les exemples suivants montrent l'utilisation correcte des macros KiXtart :
@LM "2.10"
@DATE "03/10/1997"
AFFICHER @USERID + « .TXT » affiche le fichier "RUUDV.TXT"
CD "\DONNÉES\" + @DOMAIN change le répertoire courant en "\DATA\yourdomain"
Machine Translated
KiXtart2010 113
Implémentation de l'automatisation KiXtart COM

Les paragraphes suivants décrivent l'implémentation de l'automatisation KiXtart COM.
Installation de l'implémentation KiXtart COM

Pour installer l'implémentation de KiXtart COM Automation, copiez KIXTART.DLL dans un emplacement de votre système et exécutez la
commande suivante (en utilisant un compte doté de privilèges administratifs) :
REGSVR32 KIXTART.DLL
Notez que l'implémentation COM de KiXtart, fournie dans KiXtart.dll est un produit autonome. Ce n'est pas requis par Kix32 ou
vice versa.
Utilisation de l'implémentation KiXtart COM

Une fois installée, l'interface COM KiXtart peut être utilisée à partir de n'importe quelle application Windows prenant en charge
l'automatisation COM (telle que Microsoft Excel, Visual Basic Script, etc.).
Le composant COM KiXtart s'appelle « KiXtart.Application » et peut être instancié à l'aide de l'appel CreateObject :
CréerObjet("KiXtart.Application")
Méthodes KiXtart COM
L'interface KiXtart COM prend en charge les méthodes suivantes :
SCRIPT DE LANCEMENT
Action Exécute un script KiXtart.
Syntaxe RUNSCRIPT ("nom du script", "mot de passe du script", asynchrone)

Paramètres Nom du script
Chaîne identifiant le script à exécuter.
Script de mot de
passe Chaîne facultative contenant le mot de passe avec lequel le script a été chiffré.
Asynchrone
Valeur facultative spécifiant si le script s'exécutera de manière synchrone (valeur par
défaut) ou asynchrone. Ce paramètre peut avoir les valeurs suivantes :
0 Exécuter de manière synchrone (par défaut).
1
Exécutez de manière asynchrone.
Machine Translated
114 KiXtart2010
commentaires
Un seul script peut être exécuté en même temps.
Retour
0
Script démarré
<>0
Échec du démarrage du script
Exemple Définir oMy = CreateObject("KiXtart.Application")
Si err.number = 0 Alors
x = oMy.RunScript("demo.kix")
…
…
Fin si
TERMINERSCRIPT
Action
TerminateScript peut être utilisé pour arrêter l'exécution d'un script en cours d'exécution.
Syntaxe TERMINATESCRIPT (force)

Paramètres Force
Valeur facultative spécifiant si le script doit être arrêté définitivement ou non.

0
Terminer le script (par défaut).
1
Terminez le script avec force.
commentaires
L'arrêt forcé d'un script peut avoir des effets secondaires indésirables (tels que la mémoire non libérée) et ne doit
être utilisé qu'en dernier recours pour arrêter un script suspendu.
Retour
0
Script terminé
<>0
Impossible de terminer le script
'
x = oMy.RunScript("test.kix" , , vrai ) exécuter de manière asynchrone
stat = oMy.ScriptStatus 'attendre la fin du script

attendu = 0
Do While stat = 259 Et attendu < 20
attendu = attendu + 1
wscript.sleep(1000)
stat = boucle oMy.ScriptStatus
Machine Translated
KiXtart2010 115
Si attendu = 20 Alors ' cela a
pris trop de temps, terminez le script x = oMy.TerminateScript()
Fin si
Fin si
GÉTVAR
Action
GetVar peut être utilisé pour récupérer la valeur de variables globales après l'exécution d'un script.
Syntaxe GETVAR (« nom de la variable »)

Paramètres Nom de variable
Valeur de chaîne identifiant la variable dont la valeur doit être renvoyée. Notez que les noms de toutes les
variables KiXtart commencent par un « $ », mais que vous pouvez appeler GetVar avec ou sans
le « $ ».
Retour
Valeur de la variable demandée.
x = oMy.GetVar( "MaVar" )
…
…
Fin si
SETVAR
Action
SetVar peut être utilisé pour définir la valeur des variables globales avant ou après l'exécution d'un script.
Syntaxe SETVAR (« nom de variable », nouvelle valeur)

Paramètres Nom de variable
Valeur de chaîne identifiant la variable dont définir la valeur. Si la variable n'existe pas encore,
SetVar la créera. Notez que les noms de toutes les variables KiXtart commencent par un « $ », mais que
vous pouvez appeler SetVar avec ou sans le « $ ».
Nouvelle valeur
Valeur de variante contenant la valeur à définir.
Retour
Machine Translated
116 KiXtart2010
FAUX Échec de la définition de la variable.
VRAI
La valeur a été attribuée avec succès à la variable
x = oMa.SetVar("MaVar", 12345)
'
x = oMa.SetVar("$MaVar", 12345) comme cidessus…
…
…
Propriétés de KiXtart COM
L'interface KiXtart COM prend en charge les propriétés suivantes :
ÉTAT DU SCRIPT
Description ScriptStatus peut être utilisé pour récupérer le code de sortie d'un script. Si le script est toujours
en cours d'exécution, ScriptStatus sera 259.
Retour
259
Script toujours en cours d'exécution
<>259 Script de code de sortie
'
x = oMy.RunScript("test.kix",, true) exécuter de manière asynchrone
stat = oMy.ScriptStatus 'attendre la fin du script

attendu = 0
Do While stat = 259 Et attendu < 20
attendu = attendu + 1
wscript.sleep(1000)
stat = boucle
oMy.ScriptStatus
Si attendu = 20 Alors
' cela a pris trop de temps, terminez le script x

= oMy.TerminateScript()
Machine
Machine Translated
Google
KiXtart2010 117
Fin si
Fin si
<MACROS KIXTART>
Description L'interface KiXtart COM permet d'accéder à toutes les macros KiXtart.
' afficher certaines macros de KiXtart
Wscript.Echo oMy.CPU
Wscript.Echo oMy.USERID
Wscript.Echo oMy.LDOMAIN
…
…
Fin si
Machine Translated
par Google
118 KiXtart2010
ANNEXE A : Gestion des erreurs

Pour savoir si une commande ou une fonction KiXtart réussit, vérifiez toujours les macros @ERROR et @SERROR.
Notez que la plupart des fonctions renvoient également le code d'erreur.
Si @ERROR vaut zéro, la commande ou la fonction précédente a réussi. Si @ERROR est différent de zéro, la valeur
correspond au code d'erreur renvoyé par l'API Win32 la plus récemment exécutée.
Pour savoir ce que signifie un code d'erreur spécifique, veuillez consulter la liste des codes d'erreur Win32 sur le Microsoft
Developer Network (https://msdn.microsoft.com/enus/library/windows/desktop/ms681381(v=vs. 85).aspx).
Machine Translated
KiXtart2010 119
Où trouver plus d'informations
Si vous souhaitez discuter de trucs et astuces sur l'utilisation de KiXtart et/ou partager des exemples de scripts, envisagez de rejoindre
l'une des communautés internationales d'utilisateurs de KiXtart. Pour cela, connectezvous à : http://kixtart.org
Si vous avez des commentaires ou des questions concernant KiXtart, n'hésitez pas à contacter ruudv@microsoft.com.
Pour trouver les dernières versions de KiXtart et d'autres exemples de scripts ainsi que des trucs et astuces sur KiXtart, veuillez
visiter http://kixtart.org.
Si vous souhaitez en savoir plus sur KiXtart, veuillez consulter ces excellents livres : http://
www.amazon.com/FinishScriptingKixtartGuidesAgility/dp/1932577092 http://www.amazon.com/
Windows AdminScriptingLittleBlack/dp/1932111158.
Machine Translated
par Google
120 KiXtart2010
Remerciements
KiXtart est le résultat de retours, de suggestions et d'idées de personnes du monde entier et de tous types d'organisations.
Leurs discussions passionnées, leurs tests effrénés et même leurs concours de script ont grandement contribué à produire
le résultat final vraiment passionnant qui s'appelle désormais KiXtart 2010.
Je tiens à vous exprimer mes sincères remerciements à tous, et bien sûr : Keep Scripting !
Des remerciements très particuliers vont à tous les passionnés et inconditionnels qui, au fil des années, ont soutenu KiXtart
(et m'ont gardé en vie) en hébergeant et/ou en participant activement aux sites Web, forums, listes de diffusion et
tableaux d'affichage KiXtart. Le groupe de personnes impliquées est beaucoup trop grand pour être énuméré dans son
intégralité, mais certains noms méritent absolument d'être mentionnés : Steve Wilson, Steve Ognibene, Larry
Duncan, Brian Styles, Jim Kay, Jooel Nieminen, Howard Bullock, , Kent Dyer, Les Ligetfalvy, Erik Kærholm,
Bob Kelly, Shawn Tassie, Kevin Cowans. Jochen Polster, Chris Matheson, Bryan Steele, Brad Schunk, Ben Burnett, Rob
Butler et bien sûr Henri Wiering de http://kixtart.org : merci les gars, vous faites vraiment la différence !
Encore une fois, mes sincères remerciements à vous tous, et j'espère vous revoir dans la prochaine version… !
Machine Translated
KiXtart2010 121
À propos de KiXtart
KiXtart est un projet de temps libre de Ruud van Velsen de Microsoft PaysBas.
KiXtart a été développé sur Windows 8.1 à l'aide de Microsoft Visual Studio 2013 et du kit de développement logiciel Windows.
Le format SPK utilisé par la commande PLAY a été conçu à l'origine par Gordon E. Peterson II. Les fichiers SPK ont été traduits à partir de
programmes BASIC et Assembler provenant de diverses sources du domaine public.
Avis de nonresponsabilité et informations de distribution.
LES INFORMATIONS ET LE CODE FOURNIS DANS LE CADRE DE KIXTART (CIDESSOUS DÉNOMMÉS

COLLECTIVEMENT « LOGICIEL ») SONT FOURNIS TELS QUELS SANS GARANTIE D'AUCUNE SORTE, EXPRESSE OU IMPLICITE,
Y COMPRIS MAIS SANS LIMITATION LES GARANTIES IMPLICITES DE QUALITÉ MARCHANDE ET D'ADAPTATION À UN
USAGE PARTICULIER. . EN AUCUN CAS RUUD VAN VELSEN OU MICROSOFT CORPORATION OU SES FOURNISSEURS
NE SERONT
RESPONSABLE DE TOUS DOMMAGES QUE CE SOIT, Y COMPRIS DIRECTS, INDIRECTS, ACCESSOIRES, CONSÉCUTIFS,
PERTES DE PROFITS COMMERCIAUX OU DOMMAGES SPÉCIAUX, MÊME SI RUUD VAN VELSEN OU MICROSOFT
CORPORATION OU SES FOURNISSEURS ONT ÉTÉ AVISÉS DE LA POSSIBILITÉ DE TELS DOMMAGES. CERTAINS ÉTATS
NE PERMETTENT PAS L'EXCLUSION OU
LIMITATION DE RESPONSABILITÉ POUR LES DOMMAGES CONSÉCUTIFS OU ACCESSOIRES, LA LIMITATION

PRÉCÉDENTE PEUT NE PAS S'APPLIQUER.
Ce logiciel vous est fourni sous le nom de CareWare. Ce logiciel peut être copié, installé et évalué sans redevance sous réserve des
conditions suivantes :
1. Si vous continuez à utiliser le Logiciel, vous êtes invité à faire un don caritatif comme décrit dans
le paragraphe "
Machine Translated
122 KiXtart2010
KiXtart : Vous vous en souciez ? »
2. Vous devez copier tous les logiciels sans modification et inclure toutes les pages.
3. Vous devez placer tous les avis de droits d'auteur et autres avertissements et avis de protection contenus sur le
Logiciel sur toutes les copies du Logiciel.
4. Vous ne pouvez pas distribuer ce logiciel dans un but lucratif.
5. La distribution de ce logiciel dans le cadre d'un produit ou d'un service commercial nécessite un consentement écrit
de l'auteur de ce logiciel.
6. Vous acceptez d'indemniser, de dégager toute responsabilité et de défendre Ruud van Velsen, Microsoft et ses fournisseurs.
de et contre toute réclamation ou poursuite, y compris les honoraires d'avocat, qui découlent ou résultent de l'utilisation ou de
la distribution du Logiciel.
Copyright© 2015 Ruud van Velsen. Tous droits réservés.

Kix 2010

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Kix 2010

Transféré par

Droits d'auteur :

Formats disponibles

Machine

KiXtart2010 (version 4.66)

…C'est plein de scripts...

KiXtart : Cela vous intéresse ? 4

Configuration système requise 8

Pour installer KiXtart sur un client 8

Mise à jour à partir des versions précédentes 9

Exécuter KiXtart à partir d'un fichier batch 10

Localisation des fichiers 11

Automatisation COM dans KiXtart 2010 14

Informations sur l'adhésion au groupe. 16

Règles de syntaxe générales 17

Commentaires sur les blocs

18 Variables de programme dynamiques

Référence des fonctions KiXtart 47

Référence des macros KiXtart 108

Implémentation de l'automatisation KiXtart COM 113

Propriétés KiXtart COM 116

Avis de non­responsabilité et informations de distribution. 121

KiXtart a été développé par Ruud van Velsen de Microsoft Pays­Bas.

Commandes, fonctions et macros améliorées

USE LIST Supporte désormais l'indicateur /persistent.

KiXtart : Cela vous intéresse ?

À tout le moins, tout cela prouve que KiXtart a une valeur.

Qu’est­ce que CareWare ?

Combien devrions­nous donner ?

Faire un don est plus important que le montant réel du don.

À qui devrions­nous faire un don ?

Qu'est­ce que je reçois en retour?

Comment doit­on faire un don ?

Je ne peux pas faire de don à une œuvre caritative !

soutiennent. Rejoignez le nombre croissant de supporters KiXtart CareWare dès aujourd'hui !

organisations dans le monde entier. Votre soutien a notamment permis

Fichiers KiXtart 2010

Le fichier zip KiXtart 2010 contient les fichiers suivants.

*.spk Exemples de fichiers SPK

• Kix32.exe, la version console standard de KiXtart

• Wkix32.exe, une version de KiXtart qui ne nécessite pas de console

Pour installer KiXtart sur le réseau

Pour installer KiXtart sur un client

Mise à jour à partir des versions précédentes

Pour mettre à jour KiXtart, remplacez simplement KIX32.EXE.

KiXtart peut être exécuté manuellement ou automatiquement pendant la séquence de connexion.

Pour exécuter KiXtart manuellement

À l'invite de commande, tapez la commande suivante :

Extensions par défaut

kix32 Démo.kix $Key=HKEY_LOCAL_MACHINE\Software

KiXtart prend en charge les commutateurs de ligne de commande suivants : Active

­f[:aaaa/mm/jj] Actualise le cache d'appartenance au groupe.

Remarque : disponible uniquement dans la version Windows de KiXtart.

Voir le paragraphe sur la pré­tokenisation pour plus de détails.

mot de passe pour chiffrer ou déchiffrer un script pré­tokenisé. Le mot de

Voir le paragraphe sur la pré­tokenisation pour plus de détails.

Pour exécuter Kix32.exe automatiquement lorsqu'un utilisateur se connecte

1.Ouvrez Utilisateurs et ordinateurs et sélectionnez l'utilisateur.

3. Dans la zone Script de connexion, tapez « Kix32 ».

Exécuter KiXtart à partir d'un fichier batch

Démo KIX32.kix /t /u=YourSecretPassword

Par exemple, la commande suivante :

lire le fichier "Jbond.spk"

Si cette commande est utilisée :

lire le fichier "C:Jbond.spk"

KiXtart recherche Jbond.spk uniquement dans le répertoire actuel du lecteur C.

Avis de nonresponsabilité et informations de distribution. 121

KiXtart a été développé par Ruud van Velsen de Microsoft PaysBas.

Qu’estce que CareWare ?

Combien devrionsnous donner ?

À qui devrionsnous faire un don ?

Qu'estce que je reçois en retour?

Comment doiton faire un don ?

f[:aaaa/mm/jj] Actualise le cache d'appartenance au groupe.

Voir le paragraphe sur la prétokenisation pour plus de détails.

mot de passe pour chiffrer ou déchiffrer un script prétokenisé. Le mot de

Voir le paragraphe sur la prétokenisation pour plus de détails.

un trait d'union (), peut provoquer des erreurs.

/* Les commentaires peuvent contenir des motsclés tels que

Ne peut pas contenir de caractères d'opérateur (+,,*,/,&,<,>,=)

• Signes plus (+), qui indiquent des sousexpressions concaténées

Notation à virgule flottante : [|

Utilisé pour trouver la différence entre deux nombres ou pour indiquer le