Freigeben über

Marshal.GetActiveObject-Methode

Ruft eine ausgeführte Instanz des angegebenen Objekts aus der ROT (Running Object Table) ab.

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

Syntax

'Declaration
Public Shared Function GetActiveObject ( _
    progID As String _
) As Object
'Usage
Dim progID As String
Dim returnValue As Object

returnValue = Marshal.GetActiveObject(progID)

public static Object GetActiveObject (
    string progID
)

public:
static Object^ GetActiveObject (
    String^ progID
)

public static Object GetActiveObject (
    String progID
)

public static function GetActiveObject (
    progID : String
) : Object

Parameter

  • progID
    Die ProgID des angeforderten Objekts.

Rückgabewert

Das angeforderte Objekt. Sie können dieses Objekt in eine beliebige unterstützte COM-Schnittstelle umwandeln.

Hinweise

Marshal.GetActiveObject macht die GetActiveObject-COM-API-Methode aus OLEAUT32.DLL verfügbar. Letztere erwartet jedoch eine CLSID (Klassen-ID) anstelle der ProgID (Programmbezeicher), die von dieser Methode erwartet wird. Zum Abrufen einer ausgeführten Instanz eines COM-Objekts ohne registrierte ProgID definieren Sie die GetActivateObject-COM-Methode mit einem Plattformaufruf. Eine Beschreibung eines Plattformaufrufs finden Sie unter Verwenden nicht verwalteter DLL-Funktionen. Weitere Informationen über die GetActiveObject-COM-Methode finden Sie in der MSDN Library.

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

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

Siehe auch

Referenz

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

  • Last updated on