Die Funktionieren in der ArmAccess.DLL sind hier in alphabetischer Reihenfolge aufgelistet und nach Funktionsgruppen geordnet. Mit dieser virtuellen DLL können Sie zu dem Schutzschild von Armadillo Kontakt aufnehmen, um jederzeit den aktuellen Zustand des Schutzes zu überprüfen und ggf. auf Ereignisse zu reagieren. Zusätzlich können Sie den Lizenzschlüssel, den Lizenznehmer sowie eine Reihe weiterer Umgebungsvariablen, abfragen. Einige Funktionen ermöglichen Ihnen zusätzlich, Lizenzdaten einzutragen, die Zertifikate zu prüfen usw.

Hinweis: Einige dieser Funktionen lassen Zertifikate ablaufen (oder der Schutz stellt fest, dass ein Zertifikat abgelaufen sein muß - bei Datumsänderungen beispielsweise). Armadillo setzt einfach den Wert EXPIRED. Ihre Anwendung sollte den Wert abfragen und entsprechend darauf reagieren. Wenn Sie dies während Ihrer Laufzeit nicht tun, wird die Anwendung normal laufen, bis zum nächsten Start, wenn Armadillo selbst feststellt, dass das Zertifikat abgelaufen ist.  

Tipp: Im FAQ Bereich der Onlinedokumentation gibt es noch allerlei Informationen zu den Abfragemöglichkeiten der Umgebungsvarialen, z.B. Delphi, FoxPro, C++ und Visual Basic.

Schlüssel und Zertifikate:  

VerifyKey - überprüft einen Lizenzschlüssel
InstallKey / CheckCode - Installiert einen Lizenzschlüssel
InstallKeyLater - Installiert einen Lizenzschlüssel beim Beenden der Anwendung
UninstallKey - Deinstalliert einen Lizenzschlüssel
SetDefaultKey - aktiviert das Standardzertifikat (falls vorhanden)
ExpireCurrentKey - Lässt den aktuellen Lizenzschlüssel ablaufen

Dialoge:  

ShowEnterKeyDialog - zeigt den Lizenzeingabedialog an
ShowReminderMessage - zeigt die Erinnerungsnachricht an
ShowReminderMessage2  - zeigt die zweite Erinnerungsnachricht an

Netzwerklizenzierung

CopiesRunning - Zeigt die Anzahl an Kopien an, die derzeit laufen
ConnectedToServer  - Gibt Informationen über den Server-/Clientstatus zurück

Hardwareschutz:  

ChangeHardwarelock - Ändert den Hardwarefingerprint
RawFingerprintInfo - Holt Informationen über die einzelnen Hardwarekomponenten
WriteHardwareChangeLog - schreibt ein Logfile der Änderungen der Hardware

Benutzerdefinierte Strings:  

SetUserString - Setzt einen benutzerdefinierten String
GetUserString/VBGetUserString - liest benutzerdefinierte Strings

Diverses / Sonstiges:  

GetShellProcessID - holt die Prozesskennung des Schutzschildes
FixClock - Trägt einen FixClock-Schlüssel ein
UpdateEnvironment - Aktualisiert die Umgebungsvariablen nach einer Änderung
IncrementCounter - Erhöht die Anzahl der Benutzungen Ihrer Anwendung um eins
CallBuyNowURL - Ruft den Dialog/die Website auf, um die Software zu lizenzieren
CallCustomerServiceURL - Ruft den Dialog/die Website auf, um den Kundendienst zu kontaktieren

Rückgabewerte (Error Codes)

0: ERROR_SUCCESS - Die Operation wurde erfolgreich durchgeführt. 

10: ERROR_BAD_ENVIRONMENT - Konnte keine Verbindung zu der Schutzhülle von Armadillo herstellen. Dieser Fehler tritt vorallem auf, wenn das Programm nicht geschützt ist und die virtuelle DLL nicht zur Verfügung steht. Kopieren Sie die ArmAccess.DLL in Ihr Programmverzeichnis und versuchen Sie es erneut.

12: ERROR_INVALID_ACCESS - Sie haben versucht, eine Funktion anzusprechen, die in Ihrer Edition von Armadillo nicht zulässig ist (z.B. Pro-Features oder die CallCustomerServiceURL Funktion, die nur mit den Digital River Services benutzt werden kann und Ihr Produkt nicht als solches gekennzeichnet ist) 

13: ERROR_INVALID_DATA - Es gab einen Fehler in dem Kommunikationpfad. Versuchen Sie den Aufruf der Funktion bitte nochmal. Sollte der Fehler beim zweiten Aufruf auch bestehen bleiben, so ist das Problem nicht behebbar. Der Fehler wird nur von der richtigen (nicht der virtuellen DLL) ausgegeben. 

53: ERROR_BAD_NETPATH - Es gibt kein Website/Jetzt-Kaufen-URL Eintrag in Ihrem Zertifikat oder ein Fehler ist bei dem Aufruf des Browsers aufgetreten. 

109: ERROR_BROKEN_PIPE - Konnte den Kommunikationspfad nicht öffnen. Dies ist möglicherweise ein unbehebbarer Fehler. Wird nur von der richtigen Datei ausgegeben, nicht von der virtuellen. 

111: ERROR_BUFFER_OVERFLOW - Der angegebene String ist zu lang, um gespeichert zu werden.

122: ERROR_INSUFFICIENT_BUFFER - Der angegebene Puffer ist nicht groß genug, um die angeforderten Daten aufnehmen zu können. 

170: ERROR_BUSY - Wird nur bei der CopiesRunning-Funktion zurückgegeben, wenn das Netzwerk zu beschäftigt ist, um auf die Anfrage zu antworten. Sollte im realen Leben nicht auftreten. 

1013: ERROR_CANTWRITE - Es ist ein Fehler beim Speichern der Schlüsselinformationen aufgetreten. Der Benutzer hat ggf. nicht die notwendigen Rechte, um die Werte in die Registry zu schreiben, die benötigt werden. 

1168: ERROR_NOT_FOUND - Der FixClock-Schlüssel, der übergeben wurde, war gültig, aber Armadillo hat nichts zu verbessern. Der FixClock Schlüssel ist daher NICHT auf ungültig gesetzt worden. Wenn dieser Fehler auftritt, zeigt er an, dass die Funktion richtig abgearbeitet wurde, aber keine Systemänderung notwendig war. 

1223: ERROR_CANCELLED - Sollte nach dem ShowEnterKeyDialog zurückgegeben werden, wenn der Benutzer auf Abbrechen geklickt hat ohne einen Namen und eine Seriennummer einzutragen. 

1327: ERROR_ACCOUNT_RESTRICTION - Entweder hat Armadillo ein Problem mit der Systemzeit festgestellt oder das Zertifikat unterliegt einer begrenzten Installationszeit und der Schlüssel ist nicht mehr gültig, um in die Software eingetragen zu werden. 

1331: ERROR_ACCOUNT_DISABLED - Der Schlüssel ist ein Upgradeschlüssel und der Benutzer besitzt keinen upgrade-fähigen Schlüssel. 

1341: ERROR_SERVER_DISABLED - Wird von der ConnectedToServer zurückgegeben, wenn der aktuelle Schlüssel keine Client-/Serverlizenzierung nutzt. 

1352: ERROR_INVALID_SERVER_STATE - Wird als Antwort auf ConnectedToServer zurückgegeben, wenn der Server nicht mehr erreichbar ist und die Verbindung verloren wurde (z.B. Server heruntergefahren, Netzwerkprobleme) und das aktuelle Zertifikat benutzt die Client-/Serverlizenzierung 

1373: ERROR_SPECIAL_USER - Wird von einigen funktionen aufgerufen, wenn die Funktion nicht ausgeführt werden kann, weil es sich um einen portablen Lizenzschlüssel handelt. Bei portablen Lizenzschlüsseln hat das System nicht auf die sonst üblichen, permanenten Daten Zugriff.  

1395: ERROR_LICENCE_QUOTA_EXCEEDED - Der Schlüssel wurde erfolgreich installiert, aber es gibt mehr Computer, die den Schlüssel benutzen, als die Lizenz zulässt. 

1413: ERROR_INVALID_INDEX - Der spezifizierte Index befindet sich ausserhalb des Gültigkeitsbereichs. 

1603: ERROR_INSTALL_FAILURE - Der FixClock-Schlüssel war gültig, aber Armadillo konnte die Probleme mit der Zeit nicht beheben (aus irgendeinem Grund). Der Benutzer sollte sein System rebooten und es danach erneut versuchen. Dies sollte im normalen Betrieb nie auftreten und wird hier nur zur Vollständigkeit gelistet. 

1793: ERROR_ACCOUNT_EXPIRED - Der Schlüssel war zwar in der Vergangenheit mal gültig, ist jetzt aber abgelaufen. Es sollte als unbenutzbarer Schlüssel behandelt werden. Wenn dies ein FixClock-Schlüssel ist, hat der Benutzer ggf. das Datum nicht auf das aktuelle Datum gesetzt und der Schlüssel wurde daher nicht als ungültig deklariert.

1804: ERROR_INVALID_DATATYPE - Das Zertifikat läuft nicht nach einer bestimmten Anzahl von Benutzungen ab oder der Schlüssel ist nicht über Hardwareschutzoptionen geschützt.

1909: ERROR_ACCOUNT_LOCKED_OUT - Der angegebene Schlüssel befindet sich der Liste der gestohlenen Schlüssel.

2202: ERROR_BAD_USERNAME - Der Name/Lizenzschlüssel ist für dieses Programm nicht gültig.