Teilen über

ICorDebugDataTarget::GetPlatform-Methode

  • Artikel

Stellt Informationen zur Plattform bereit, einschließlich Prozessorarchitektur und Betriebssystem, auf denen der Zielprozess ausgeführt wird

Syntax

HRESULT GetPlatform([out] CorDebugPlatform * pTargetPlatform);

Parameter

pTargetPlatform
[out] Ein Zeiger auf eine CorDebugPlatformEnum-Enumeration, die die Zielplattform beschreibt

Bemerkungen

Der CorDebugPlatformEnum-Enumerationsrückgabewert wird von der ICorDebug-Schnittstelle verwendet, um Details des Zielprozesses zu bestimmen, z. B. Zeigergröße, Adressraumlayout, Registersatz, Anweisungsformat, Kontextlayout und Aufrufkonventionen.

Der pTargetPlatform-Wert kann auf eine Plattform verweisen, die für das Ziel emuliert wird, anstatt die tatsächliche verwendete Hardware anzugeben. Beispielsweise sollte ein Prozess, der in der WoW-Umgebung (Windows on Windows) unter einer 64-Bit-Edition des Windows-Betriebssystems ausgeführt wird, den CORDB_PLATFORM_WINDOWS_X86-Wert der CorDebugPlatformEnum-Enumeration verwenden.

Diese Methode muss erfolgreich sein. Schlägt sie fehl, ist die Zielplattform unbrauchbar. Die Methode kann aus den folgenden Gründen fehlschlagen:

  • Die Plattform, die für das Ziel emuliert wird, ist nicht verwendbar.

  • Die tatsächliche Hardware auf der Zielplattform ist unbrauchbar.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit Version 4 verfügbar

Siehe auch