SysReAllocStringLen-Funktion (oleauto.h)
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 |
|---|---|
|
Die Zeichenfolge wurde erfolgreich neu zugeordnet. |
|
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 |