XProfan

Español

Descripción:

FormatMessage liefert de una Fehlercode (Zahl) una Descripción des Fehlers (String) oder Formatiert una solche Meldungsdefinition neu.

Deklaration:

DEF @FormatMessage(7) !KERNEL32,FormatMessageA

Parámetro:

1.Parámetro: Flags para el Art el Erzeugung des Rückgabestrings. Flags puede con | addiert voluntad. =>
- $100 (FORMAT_MESSAGE_ALLOCATE_BUFFER) = Der fünfte Parámetro son el minimale Größe des Buffers para el Stringrückgabe a. Das Sistema berechnet el erforderliche Größe incluso y Speicher muß später con LocalFree freigegeben voluntad.
- $200 (FORMAT_MESSAGE_IGNORE_INSERTS).= Platzhalter innerhalb des Rückgabestrings voluntad unverändert para una spätere Bearbeitung transferencia. Parámetro 7 se ignoriert.
- $400 (FORMAT_MESSAGE_FROM_STRING) = Parámetro 2 Es el Adresse uno nullterminierten Meldungsdefinition. Dieser Flag kann no con $800 y $1000 verwendet voluntad.
- $800 (FORMAT_MESSAGE_FROM_HMODULE) = Parámetro 2 es el Handle uno Moduls (DLL). Kann no con $400 kombiniert voluntad.
- $1000 (FORMAT_MESSAGE_FROM_SYSTEM) = Durchsucht el Systemmeldungstabellen después de el Rückgabestring. Kann no con $400 kombiniert voluntad.
- $2000 (FORMAT_MESSAGE_ARGUMENT_ARRAY) = Parámetro 7 Es el Adresse uno Arrays con Argumenten para el Formatierung.
- $FF = Zeilenumbrüche en el Rückgabestring voluntad en el Regel ignoriert.
- $1 a $FE = Maximale Anzahl de Buchstaben a para Zeilenumruch.
- $0 = Zeilenumbrüche en el Rückgabestring voluntad übernommen.

2.Parámetro: Gibt a, wo el Rückgabestring gesucht voluntad se. =>
- Wenn en Parámetro 1 $800 angegeben wurde, es hier el Handle uno Moduls (DLL), el el Rückgabestring liefert.
- Wenn en Parámetro 1 $400 angegeben wurde, es hier el Adresse uno unformatierten Rückgabestrings dieser Función (Meldungsdefinition). Er kann entonces con dieser Función más formatiert voluntad.
- In allen otro Fällen se dieser Parámetro ignoriert.

3.Parámetro: LongIntvariable con el Identifierer uno Meldung, como ihn z.B. GetLastError liefert. Wenn en Parámetro 1 $400 angegeben wurde, se dieser Parámetro ignoriert.

4.Parámetro: Identifier uno Lingua para el Rückgabestring. 0 para aktuelle Lingua. Dieser Parámetro se ignoriert, si en Parámetro 1 $400 angegeben wurde.

5.Parámetro: Wenn en Parámetro 1 $2000 angegeben wurde, es hier una LongIntvariable oder 4 Byte große Bereichsvariable, el el Adesse des Rückgabestrings aufnimmt. Ansonsten una ausreichend dimensionierte Bereichsvariable, el el Rückgabestring aufnimmt.

6.Parámetro: Wenn en Parámetro 1 $2000 angegeben wurde, es hier el minimale Größe des Bereichs de Parámetro 5 como LongInt. Ansonsten es hier el Größe de Parámetro 5 en Bytes (ANSI) oder Buchstaben (Unicode).

7.Parámetro: Parámetro para el Formatierung. Wenn Parámetro 1 $2000 enthält, es hier una Bereichsvariable con el para eventuell vorhandene Platzhalter einzusetzenden Cuerdas. Ansonsten es dieser Parámetro el Adresse uno va_list Struktur.

Rückgabewert:

0 en Fehler, ansonsten el número el Bytes (ANSI) oder Signo (Unicode), el Zurückgeliefert fueron.

Beispiele:

Kompilieren Marca Separación

DEF @FormatMessage(7) !"KERNEL32","FormatMessageA"
Declare Rückgabe&,GETERROR_Buffer#,GETERROR_Buffer$
DIM GETERROR_Buffer#,32000
Let Rückgabe&=1314 Rückgabe von GetLastError oder direkt von einer API
@FormatMessage($1000,0,Rückgabe&,0,GETERROR_Buffer#,32000,0) Wandelt Fehlercode in Landesspezifische Message um.
Let GETERROR_Buffer$=@STRING$(GETERROR_Buffer#,0)
Dispose GETERROR_Buffer#
@messagebox(GETERROR_Buffer$,"Fehlermeldung",64)