ICorDebugDataTarget::GetPlatform-Methode

Stellt Informationen über die Plattform, einschließlich Prozessorarchitektur und Betriebssystem, bereit, auf der der Zielprozess ausgeführt wird.

HRESULT GetPlatform([out] CorDebugPlatform * pTargetPlatform);

Parameter

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

Hinweise

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

Der pTargetPlatform-Wert verweist möglicherweise auf eine Plattform, die für das Ziel emuliert wird, statt die tatsächlich verwendete Hardware anzugeben. Beispielsweise sollte ein Prozess, der in der WOW (Windows on Windows)-Umgebung auf einem 64-Bit-Windows-Betriebssystem ausgeführt wird, den CORDB_PLATFORM_WINDOWS_X86-Wert der CorDebugPlatformEnum-Enumeration verwenden.

Diese Methode muss erfolgreich ausgeführt werden. Wenn sie fehlschlägt, ist die Zielplattform unbrauchbar. Die Methode kann aus den folgenden Gründen fehlschlagen: