SysAllocStringLen-Funktion (oleauto.h)

  • Artikel

Ordnet eine neue Zeichenfolge zu, kopiert die angegebene Anzahl von Zeichen aus der übergebenen Zeichenfolge und fügt ein NULL-Endzeichen an.

Syntax

BSTR SysAllocStringLen(
  [in] const OLECHAR *strIn,
  [in] UINT          ui
);

Parameter

[in] strIn

Die Eingabezeichenfolge.

[in] ui

Die Anzahl der zu kopierenden Zeichen. Anschließend wird ein NULL-Zeichen platziert, das eine Gesamtanzahl von UI plus ein Zeichen zugibt.

Rückgabewert

Eine Kopie der Zeichenfolge oder NULL , wenn nicht genügend Arbeitsspeicher vorhanden ist, um den Vorgang abzuschließen.

Hinweise

Die Zeichenfolge kann eingebettete NULL-Zeichen enthalten und muss nicht mit NULL enden. Geben Sie die zurückgegebene Zeichenfolge später mit SysFreeString frei. Wenn strIn nicht NULL ist, muss der strIn zugeordnete Arbeitsspeicher mindestens UI-Zeichen lang sein.

Hinweis Diese Funktion konvertiert keine char *-Zeichenfolge in einen Unicode-BSTR.
 

Anforderungen

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

Weitere Informationen

Zeichenfolgenbearbeitungsfunktionen