SysAllocStringLen-Funktion (oleauto.h)
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 |