Udostępnij za pośrednictwem


CreateDebuggingInterfaceFromVersion, funkcja (.NET Framework)

Tworzy obiekt ICorDebug na podstawie określonych informacji o wersji.

Ta funkcja jest przestarzała w programie .NET Framework 4. Zamiast tego, aby uzyskać interfejs środowiska uruchomieniowego języka wspólnego (CLR) 2.0, użyj metody ICLRRuntimeInfo::GetInterface i określ identyfikator klasy CLSID_CLRDebuggingLegacy i identyfikator interfejsu IID_ICorDebug. Aby uzyskać interfejs środowiska CLR 4 lub nowszego, wywołaj funkcję CLRCreateInstance i określ identyfikator klasy CLSID_CLRDebugging i identyfikator interfejsu IID_ICLRDebugging.

Składnia

HRESULT CreateDebuggingInterfaceFromVersion (
    [in]  int      iDebuggerVersion,
    [in]  LPCWSTR  szDebuggeeVersion,
    [out] IUnknown **ppCordb
);

Parametry

iDebuggerVersion
[in] Wersja tej wersji ICorDebug jest oczekiwana przez debuger. Aby uzyskać prawidłowe wartości, zobacz wyliczenie CorDebugInterfaceVersion.

szDebuggeeVersion
[in] Wersja środowiska uruchomieniowego języka wspólnego skojarzona z aplikacją lub procesem do debugowania. Aby uzyskać informacje na temat pobierania tej wartości, zobacz metodę GetVersionFromProcess lub GetRequestedRuntimeVersion .

ppCordb
[out] Lokalizacja, która odbiera wskaźnik do ICorDebug obiektu.

Wartość zwracana

Ta metoda zwraca standardowe kody błędów COM zdefiniowane w pliku WinError.h oprócz następujących wartości.

Kod powrotu opis
S_OK Metoda została ukończona pomyślnie.
E_INVALIDARG szDebuggeeVersion lub ppCordb ma wartość null lub ciąg wersji jest niepoprawny.

Uwagi

Parametr szDebuggeeVersion jest mapowany na odpowiednią wersję biblioteki MSCorDbi.dll.

Wymagania

Platformy: zobacz Wymagania systemowe.

Nagłówek: MSCorEE.h

Biblioteka: MSCorEE.dll

Wersje programu .NET Framework: dostępne od wersji 2.0

Zobacz też