SysAllocString
Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]
Reserviert eine neue Zeichenfolge und kopiert die übergebene Zeichenfolge hinein.
BSTR SysAllocString(
const OLECHAR *sz
);
Parameter
- sz
Eine 0 (null) endende Zeichenfolge, die kopieren. Der Parameter sz muss eine Unicode-Zeichenfolge in 32-Bit-Anwendungen und eine ANSI-Zeichenfolge in 16-Bit-Anwendungen sein. Das Argument sz kann NULL sein.
Rückgabewert
Wenn erfolgreich, gibt einen BSTR, der die Zeichenfolge enthält. Wenn sz eine Zeichenfolge der Länge Null ist, gibt einen BSTR Länge 0 (null) zurück. Wenn sz NULL ist oder nicht genügend Arbeitsspeicher vorhanden ist, gibt NULL zurück.
Kommentare
Sie können mit SysAllocStringSysFreeString mit erstellte Zeichenfolgen freigeben.
Beispiel
inline void CStatBar::SetText(OLECHAR * sz)
{
SysFreeString(m_bstrMsg); // Free previous string, if any.
m_bstrMsg = SysAllocString(sz);
// Caller should check to see if m_bstrMsg is null after calling this method.
}