StrToInt64ExA-Funktion (shlwapi.h)

Artikel
11/20/2024

Konvertiert eine Zeichenfolge, die einen Dezimal- oder Hexadezimalwert darstellt, in eine 64-Bit-Ganzzahl.

Syntax

BOOL StrToInt64ExA(
  [in]  PCSTR      pszString,
        STIF_FLAGS dwFlags,
  [out] LONGLONG   *pllRet
);

Parameter

[in] pszString

Typ: PCTSTR-

Ein Zeiger auf die null-terminated string to be converted. Weitere Informationen zu den gültigen Formen der Zeichenfolge finden Sie im Abschnitt "Hinweise".

dwFlags

Typ: STIF_FLAGS

Einer der folgenden Werte, die angeben, wie pszString- für die Konvertierung in eine 64-Bit-Ganzzahl analysiert werden soll.

STIF_DEFAULT

Die Zeichenfolge bei pszString enthält die Darstellung eines Dezimalwerts.

STIF_SUPPORT_HEX

Die Zeichenfolge bei pszString enthält die Darstellung eines Dezimal- oder Hexadezimalwerts. Beachten Sie, dass bei hexadezimalen Darstellungen die Zeichen A-F die Groß-/Kleinschreibung nicht beachtet.

[out] pllRet

Typ: LONGLONG*

Ein Zeiger auf eine Variable vom Typ LONGLONG-, die den 64-Bit-Ganzzahlwert der konvertierten Zeichenfolge empfängt. Bei der Zeichenfolge "123" erhält beispielsweise die ganze Zahl, auf die dieser Wert verweist, den Wert 123.

Wenn diese Funktion FALSE-zurückgibt, ist dieser Wert nicht definiert.

Wenn der zurückgegebene Wert zu groß ist, um in einer Variablen vom Typ LONGLONGenthalten zu sein, enthält dieser Parameter die 64 Bit mit niedriger Reihenfolge des Werts. Alle hochgeordneten Bits, die darüber hinausgehen, gehen verloren.

Rückgabewert

Typ: BOOL-

Gibt TRUE- zurück, wenn die Zeichenfolge konvertiert wird; andernfalls FALSE.

Bemerkungen

Die Zeichenfolge, auf die der pszString-Parameter verweist, muss eines der folgenden Formulare aufweisen, damit sie erfolgreich analysiert werden können.

Dieses Formular wird als Dezimalwert unter beiden Kennzeichen akzeptiert. ''' Syntax (optionales Leerzeichen)(optionales Vorzeichen)(eine oder mehrere Dezimalziffern) '''
Diese Formulare sind für Hexadezimalwerte erforderlich, wenn das flag STIF_SUPPORT_HEX übergeben wird. ''' Syntax (optionaler Leerraum)(optionales Zeichen)0x(eine oder mehrere Hexadezimalziffern) '''
```
(optional white space)(optional sign)0X(one or more hexadecimal digits)
```

Das optionale Zeichen kann das Zeichen "-" oder "+" sein; wenn nicht angegeben, wird davon ausgegangen, dass das Vorzeichen positiv ist.

Note If the value is parsed as hexadecimal, the optional sign is ignored, even if it is a '-' character. Beispielsweise wird die Zeichenfolge "-0x1" anstelle von -1 als 1 analysiert.

Wenn die Zeichenfolge, auf die pszString verweist, ein ungültiges Zeichen enthält, wird dieses Zeichen als Das Ende der zu konvertierenden Zeichenfolge betrachtet, und der Rest wird ignoriert. Bei der ungültigen Hexadezimalzeichenfolge "0x00am123" erkennt StrToInt64Ex nur "0x00a", konvertiert sie in den ganzzahligen Wert 10 und gibt TRUEzurück.

Wenn pllRet-NULL-ist, gibt die Funktion TRUE zurück, wenn die Zeichenfolge konvertiert werden kann, auch wenn sie die Konvertierung nicht ausführt.

Anmerkung

Der Header "shlwapi.h" definiert StrToInt64Ex als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 5.0 oder höher)

Freigeben über