Marshal.FreeBSTR-Methode

Gibt mit SysFreeString einen BSTR frei.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Sub FreeBSTR ( _
    ptr As IntPtr _
)
'Usage
Dim ptr As IntPtr

Marshal.FreeBSTR(ptr)

public static void FreeBSTR (
    IntPtr ptr
)

public:
static void FreeBSTR (
    IntPtr ptr
)

public static void FreeBSTR (
    IntPtr ptr
)

public static function FreeBSTR (
    ptr : IntPtr
)

Parameter

• ptr
  Die Adresse des freizugebenden BSTR.

Hinweise

Wie Marshal.FreeCoTaskMem und Marshal.FreeHGlobal können Sie diese Methode verwenden, um die Reservierung von Speicher aufzuheben. FreeBSTR ruft SysFreeString auf, eine COM-API-Methode, die Speicher freigibt, der von einer der folgenden nicht verwalteten Methoden reserviert wurde: SysAllocString, SysAllocStringByteLen, SysAllocStringLen, SysReAllocString, SysReAllocStringLen. Sie können nicht verwaltete Methoden wie diese mit einem Plattformaufruf aufrufen. Ausführliche Informationen finden Sie unter Verwenden nicht verwalteter DLL-Funktionen.

Hinweis

Diese Methode verwendet SecurityAction.LinkDemand, um einen Aufruf aus nicht vertrauenswürdigem Code zu verhindern. Nur der direkte Aufrufer muss über die SecurityPermissionAttribute.UnmanagedCode-Berechtigung verfügen. Wenn der Code aus teilweise vertrauenswürdigem Code aufgerufen werden kann, dürfen Benutzereingaben nicht ohne Validierung an Methoden der Marshal-Klasse übergeben werden. Wichtige Einschränkungen bei der Verwendung des LinkDemand-Members finden Sie unter "Demand" und "LinkDemand".

.NET Framework-Sicherheit

• SecurityPermission  für die Berechtigung zum Aufrufen von nicht verwaltetem Code. Zugeordnete Enumeration: UnmanagedCode Sicherheitsaktion: LinkDemand

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

Marshal-Klasse
Marshal-Member
System.Runtime.InteropServices-Namespace
Marshal.FreeCoTaskMem
Marshal.FreeHGlobal