SysReAllocStringLen-Funktion (oleauto.h)

  • Artikel

Erstellt einen neuen BSTR mit einer angegebenen Anzahl von Zeichen aus einem alten BSTR und gibt den alten BSTR frei.

Syntax

INT SysReAllocStringLen(
  [in, out]      BSTR          *pbstr,
  [in, optional] const OLECHAR *psz,
  [in]           unsigned int  len
);

Parameter

[in, out] pbstr

Die zuvor zugeordnete Zeichenfolge.

[in, optional] psz

Die Zeichenfolge, aus der Len-Zeichen kopiert werden sollen, oder NULL, um die Zeichenfolge nicht initialisiert zu halten.

[in] len

Die Anzahl der zu kopierenden Zeichen. Anschließend wird ein NULL-Zeichen eingefügt, das eine Summe von len plus ein Zeichen zugibt.

Rückgabewert

Rückgabecode Beschreibung
TRUE
 Die Zeichenfolge wurde erfolgreich neu zugeordnet.
FALSE
 Es ist nicht genügend Arbeitsspeicher vorhanden.

Hinweise

Ordnet eine neue Zeichenfolge zu, kopiert Len-Zeichen aus der übergebenen Zeichenfolge in die Zeichenfolge und fügt dann ein NULL-Zeichen an. Gibt den BSTR frei, auf den derzeit von pbstr verwiesen wird, und setzt pbstr zurück, um auf den neuen BSTR zu verweisen. Wenn psz NULL ist, wird eine Zeichenfolge der Länge len zugeordnet, aber nicht initialisiert.

Die psz-Zeichenfolge kann eingebettete NULL-Zeichen enthalten und muss nicht mit null enden.

Wenn dieser Funktion ein NULL-Zeiger übergeben wird, liegt eine Zugriffsverletzung vor, und das Programm stürzt ab. Es liegt in Ihrer Verantwortung, diese Funktion vor NULL-Zeigern zu schützen.

Anforderungen

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

Weitere Informationen

Zeichenfolgenbearbeitungsfunktionen