StrToInt64ExW-Funktion (shlwapi.h)
Konvertiert eine Zeichenfolge, die einen Dezimal- oder Hexadezimalwert darstellt, in eine 64-Bit-Ganzzahl.
Syntax
BOOL StrToInt64ExW(
[in] PCWSTR pszString,
STIF_FLAGS dwFlags,
[out] LONGLONG *pllRet
);
Parameter
[in] pszString
Typ: PCTSTR
Ein Zeiger auf die zu konvertierende NULL-Zeichenfolge. Weitere Informationen zu den gültigen Formen der Zeichenfolge finden Sie im Abschnitt Hinweise.
dwFlags
Typ: STIF_FLAGS
Einer der folgenden Werte, der angibt, 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 bei den Zeichen A bis F die Groß-/Kleinschreibung nicht beachtet wird.
[out] pllRet
Typ: LONGLONG*
Ein Zeiger auf eine Variable vom Typ LONGLONG , die den ganzzahligen 64-Bit-Wert der konvertierten Zeichenfolge empfängt. Für instance erhält die ganze Zahl, auf die dieser Wert verweist, im Fall der Zeichenfolge "123" 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 LONGLONG enthalten zu sein, enthält dieser Parameter die 64 Bits mit niedriger Reihenfolge des Werts. Alle darüber hinaus geordneten Bits gehen verloren.
Rückgabewert
Typ: BOOL
Gibt TRUE zurück, wenn die Zeichenfolge konvertiert wird. andernfalls FALSE.
Hinweise
Die Zeichenfolge, auf die der pszString-Parameter verweist, muss über eines der folgenden Formulare verfügen, um erfolgreich analysiert zu werden.
- Dieses Formular wird als Dezimalwert unter beiden Flags akzeptiert. Syntax ''' (optionaler Leerraum)(optionales Vorzeichen)(eine oder mehrere Dezimalstellen) '''
- Diese Formulare sind für hexadezimale Werte erforderlich, wenn das flag STIF_SUPPORT_HEX übergeben wird.
Syntax ''' (optionaler Leerraum)(optionales Vorzeichen)0x(eine oder mehrere Hexadezimalstellen) '''
(optional white space)(optional sign)0X(one or more hexadecimal digits)
Wenn pllRetNULL ist, gibt die Funktion TRUE zurück, wenn die Zeichenfolge konvertiert werden kann, obwohl sie die Konvertierung nicht ausführt.
Hinweis
Der shlwapi.h-Header definiert StrToInt64Ex als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shlwapi.h |
Bibliothek | Shlwapi.lib |
DLL | Shlwapi.dll (Version 5.0 oder höher) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für