Wie funktioniert API Programmierung?

[AHT]

Erklärt an der API MoveFile:

Wie erhält man die zu der API gehörenden DLL :
Wir schauen uns dazu mal die API Beschreibung auf der Microsoft Seite an. Ganz unten steht folgendes:

Requirements

Minimum supported client Windows 2000 Professional
Minimum supported server Windows 2000 Server
Header WinBase.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll
Unicode and ANSI names MoveFileW (Unicode) and MoveFileA (ANSI)

Da steht also die DLL in der sich die Funktion MoveFile befindet.

Wie erhälte ich den genauen Funktionsnamen in der DLL:
Bei uns hier in Deutschland gibt es das Alphabeth. Aus den dort enthaltenen Buchstaben (es sind so um die 26) kann man eigentlich jedes Wort und jeden Satz der Deutschen Sprache bilden.
In Japan sieht das ganz anders aus, da gibt es viel mehr Schriftzeichen, aus denen die einzelnen Worte gebildet werden. Es gibt bei den meisten APIs, die in irgendeiner Form mit Textausdrücken umgehen (bei MoveFile ist das zum Beispiel der Name des Quell- und Zielordners), deshalb öft zwei Versionen - hier
- MoveFileA -> kann mit dem euopäschien (kurzen) Zeichensatz umgehen
- MoveFileW -> kann mit einem erweiterten Zeichensatz umgehen, wie zum Beispiel den japanischen Schriftzeichen.
Ich habe hier MoveFileA gewählt - allgemein für Nicht-Asiaten die erste Wahl.

Requirements

Minimum supported client Windows 2000 Professional
Minimum supported server Windows 2000 Server
Header WinBase.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll
Unicode and ANSI names MoveFileW (Unicode) and MoveFileA (ANSI)

Wie erhalte ich die Parameter, mit der die Funktion aufgerufen wird:
Dafür ist folgender Abschnitt wichtig:

Syntax

C++

BOOL WINAPI MoveFile(
__in LPCTSTR lpExistingFileName,
__in LPCTSTR lpNewFileName);

Wie man hier sieht, hat die Funktion zwei Parameter. __in bedeuted, es sind Parameter für die Eingabe - man muss also vorher was emtsprechendes in die Parameter packen, damit die Funktion erfolgreich was tut. Es könnte dort auch __out stehen, dann packt die Funktion dort selbst was hin, was man später auslesen kann.
Jetzt schauen wir uns mal das LPCTSTR etwas genauer an. STR wird dir bekannt vorkommen - da gibt es doch die Funktion Str$ aus Profan! STR ist also ein String und LP beudet nichts anderes als eine Adresse. Es muss bei beiden Parametern also die Adresse eines Strings übermittelt werden - einmal die Adresse des Quellordners (der Quelldatei) und einmal die Adresse des Zielordners (der Zieldatei).



Folgende Sachen könnten dort unter anderem bei anderen Funktionen noch stehen (hier das wichtigste für den Anfang):

• DWORD = Eine 4 Byte große Zahl (Zahl&)
• WORD = Eine 2 Byte große Zahl
• Byte = 0 oder 1 -> eine 1 Byte große Zahl

Wo finde ich Funktion, die mich interessieren könnten:
Es gibt da einen netten Download, der die wichtigsten Funktionen etwas geordnet enthält (win32.hlp). Das ganze ist schon ziemlich veraltet, zum ersten Nachschlagen reicht es aber noch.

[Gerhard Putschalka]

Wie erhalte ich die zu der API gehörende DLL?

Der Link funktioniert - am Beispiel MoveFile.

Gibt es einen Link wo ich eine Übersicht finde um zu einem Funktionsnamen die zugehörige DLL zu finden? Ich habe vergeblich gesucht.
Die Möglichkeit der Win32.hlp kenne ich, aber ich sollte die Information auch auf der microsoft Seite finden können.

Gruß
Gerhard

[AHT]

Hast du einen Funktionsnamen, hilft in der Regel Google - hier mal CreateMutex, suche nachte CreateMutex und MSDN:

CreateMutex msdn - Google-Suche

Gans oben findet man dann die MSDN Seite mit der englischen Erklärung.
Ganz unten steht dort auf der Seite:

DLL Kernel32.dll

Die Funktion kommt also aus der Kernel32.DLL.

Arbeitet man eine Zeitlang mit der API-Programmierung, bekommt man alleine vom Namen der Funktion her schon ein Gespür dafür, für was die gut ist.
Ich habe mir damals Tasks and Token geschrieben - mit dem Tool kann man unter anderem die einzelnen DLLs auf Exportfunktionen hin untersuchen (wahlweise mit Name oder Ordnungszahl).
Ich mache ja ab und zu auch was mit undokumentierten Sachen - ich schaue dann auch einfach bei Google nach, was ich über diese Funktion finde und prüfe auf meinen Rechnern, ab welcher Windowsversion es diese API überhaupt gibt. Kennt man sich da aus, kann man da eine ganze Menge zaubern.

[Jac de Lad]

Gut erklärt. MSDN hilft da immer.

[AHT]

Soweit es dokumentiert ist, ja - amsonsten muss man auf anderen Seiten suchen.

[H.Brill]

Habs früher mal in etwa so gelernt :

Die 3 wichtigsten DLLs in Windows -> Kernel32, User32, GDI32
Kernel32 :
- dort sind alle Systeminformationen und Funktionen
(Arbeitsspeicher, Dateien usw.)
GDI32 :
- Alle Funktionen u. Informationen zum Zeichnen
USER32 :
- Alles, was mit Controls zusammen hängt (Fenster, Buttons,
Listboxen, Editfelder.....)

Wenn man das im Hinterkopf behält, kann man schon etliche
Funktionen den jeweiligen DLLs zuordnen und braucht nur noch
nach den jeweiligen Parametern zu forschen.

[Gerhard Putschalka]

Danke, es funktioniert sehr gut.

Mfg
Gerhard

[p. specht]

Ja, langsam kommt auch bei mir System in die Sache.
Nochmals vielen Dank!

[Gerhard Putschalka]

Ab morgen sollte die neue Version (Datum 13.6.2010) auf meiner Seite sein.
Mfg
Gerhard.

[AHT]

Genial finde ich auch die API Kurse von Uwe Pascal Niemeyer: API Grundkurse von Uwe Niemeier
Wer das durchgearbeitet hat, kann API programmieren. Die Sachen sind gut und einfach erklärt.