Teilen über


SysAddRefString-Funktion (oleauto.h)

Hinweis Sie sollten SysAddRefString nur aufrufen, wenn Sie eine Skript-Engine implementieren, die sich vor der Ausführung potenziell schädlicher Skripts schützen muss.
 
Erhöht die Anheftverweisanzahl für die angegebene Zeichenfolge um eins.

Syntax

HRESULT SysAddRefString(
  [in] BSTR bstrString
);

Parameter

[in] bstrString

Die Zeichenfolge, für die die Anheftverweisanzahl erhöht werden soll. Während diese Anzahl größer als 0 bleibt, wird durch Aufrufe der SysFreeString-Funktion verhindert, dass der Arbeitsspeicher für die Zeichenfolge freigegeben wird.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Zeichenfolgen mit dem BSTR-Datentyp weisen traditionell keine Verweisanzahl auf. Die gesamte vorhandene Verwendung dieser Zeichenfolgen funktioniert weiterhin ohne Änderungen. Die Funktionen SysAddRefString und SysReleaseString fügen die Möglichkeit hinzu, die Verweiszählung zu verwenden, um die Zeichenfolge in den Arbeitsspeicher anzuheften, bevor sie von einem nicht vertrauenswürdigen Skript in eine IDispatch-Methode aufrufen, die möglicherweise nicht erwartet, dass das Skript diesen Arbeitsspeicher freigibt, bevor die Methode zurückgibt, sodass das Skript den Code für diese Methode nicht erzwingen kann, um auf den freigegebenen Arbeitsspeicher zuzugreifen. Nachdem eine solche Methode sicher zurückgegeben wird, sollten die anheftenden Verweise durch Aufrufen von SysReleaseString freigegeben werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile oleauto.h
Bibliothek Mincore.lib
DLL Oleaut32.dll

Weitere Informationen

BSTR

SysReleaseString