ICorDebugDataTarget::GetPlatform Method

Provides information about the platform, including processor architecture and operating system, on which the target process is running.

Syntax

HRESULT GetPlatform([out] CorDebugPlatform * pTargetPlatform);

Parameters

pTargetPlatform [out] A pointer to a CorDebugPlatformEnum enumeration that describes the target platform.

Remarks

The CorDebugPlatformEnum enumeration return value is used by the ICorDebug interface to determine details of the target process such as its pointer size, address space layout, register set, instruction format, context layout, and calling conventions.

The pTargetPlatform value may refer to a platform that is being emulated for the target instead of specifying the actual hardware in use. For example, a process that is running in the Windows on Windows (WOW) environment on a 64-bit edition of the Windows operating system should use the CORDB_PLATFORM_WINDOWS_X86 value of the CorDebugPlatformEnum enumeration.

This method must succeed. If it fails, the target platform is unusable. The method may fail for the following reasons:

  • The platform that is being emulated for the target is unusable.

  • The actual hardware on the target platform is unusable.

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4

See also