VarParseNumFromStr-Funktion (oleauto.h)

  • Artikel

Analysiert eine Zeichenfolge und erstellt eine typunabhängige Beschreibung der Zahl, die sie darstellt.

Syntax

HRESULT VarParseNumFromStr(
  [in]  LPCOLESTR strIn,
  [in]  LCID      lcid,
  [in]  ULONG     dwFlags,
  [out] NUMPARSE  *pnumprs,
  [out] BYTE      *rgbDig
);

Parameter

[in] strIn

Die zu konvertierende Eingabezeichenfolge.

[in] lcid

Der Gebietsschemabezeichner.

[in] dwFlags

Ermöglicht es dem Aufrufer, die Analyse zu steuern und daher die akzeptable Syntax einer Zahl zu definieren. Wenn dieses Feld auf null festgelegt ist, darf die Eingabezeichenfolge nichts anderes als Dezimalstellen enthalten. Das Festlegen jedes definierten Flagbits ermöglicht die Analyse dieses syntaktischen Features. Bei der Standardautomatisierungsanalyse (z. B. wie von VarI2FromStr) sind alle Flags festgelegt (NUMPRS_STD).

[out] pnumprs

Die analysierten Ergebnisse.

[out] rgbDig

Die Werte für die Ziffern im Bereich 0–7, 0–9 oder 0–15, je nachdem, ob die Zahl oktal, dezimal oder hexadezimal ist. Alle führenden Nullen wurden entfernt. Bei Dezimalzahlen werden nachfolgende Nullen ebenfalls entfernt, es sei denn, die Zahl ist 0. In diesem Fall ist eine einzelne Nullziffer vorhanden.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_OUTOFMEMORY
 Fehler bei der internen Speicherzuordnung. (Wird nur für DBCS verwendet, um eine Kopie mit eng zugeordneten Breitenzeichen zu erstellen.)
DISP_E_TYPEMISMATCH
 Es gibt keine gültige Zahl in der Zeichenfolge, oder es gibt keine schließende Klammer, die mit einer öffnenden Klammer übereinstimmt. Im ersten Fall sind cDig und cchUsed in der NUMPARSE-Struktur 0. In letzterem werden die NUMPARSE-Struktur und das Ziffernarray vollständig aktualisiert, als ob die schließende Klammer vorhanden wäre.
DISP_E_OVERFLOW
 Für hexadezimale und oktale Ziffern gibt es mehr Ziffern, als in das Array passen. Bei Dezimalstellen überschreitet der Exponent das maximal mögliche. In beiden Fällen werden die NUMPARSE-Struktur und das Ziffernarray vollständig aktualisiert (bei Dezimalstellen schließt das Feld cchUsed den gesamten Exponenten aus).

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile oleauto.h
Bibliothek OleAut32.lib
DLL OleAut32.dll