CreateVersionStringFromModule – funkce

Článek
09/22/2023

Vytvoří řetězec verze z cesty CLR (Common Language Runtime) v cílovém procesu.

Syntaxe

HRESULT CreateVersionStringFromModule (
    [in]  DWORD      pidDebuggee,
    [in]  LPCWSTR    szModuleName,
    [out, size_is(cchBuffer),
    length_is(*pdwLength)] LPWSTR Buffer,
    [in]  DWORD      cchBuffer,
    [out] DWORD*     pdwLength
);

Parametry

pidDebuggee
[v] Identifikátor procesu, ve kterém je načten cílový modul CLR.

szModuleName
[v] Úplná nebo relativní cesta k cílovému clru, který je načten v procesu.

pBuffer
[ven] Návratová vyrovnávací paměť pro uložení řetězce verze pro cílový CLR.

cchBuffer
[v] Velikost .pBuffer

pdwLength
[ven] Délka řetězce verze vráceného řetězcem pBuffer.

Vrácená hodnota

S_OK
Řetězec verze pro cílový CLR byl úspěšně vrácen v pBuffersouboru .

E_INVALIDARG
szModuleName je null, nebo pBuffercchBuffer je null. pBuffer a cchBuffer musí mít hodnotu null nebo nesmí mít hodnotu null.

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
pdwLength je větší než cchBuffer. To může být očekávaný výsledek, pokud jste předali hodnotu null pro obě pBuffer a cchBuffera dotazovali se na potřebnou velikost vyrovnávací paměti pomocí .pdwLength

HRESULT_FROM_WIN32(ERROR_MOD_NOT_FOUND)
szModuleName neobsahuje cestu k platnému CLR v cílovém procesu.

E_FAIL (nebo jiné E_ návratové kódy)
pidDebuggee neodkazuje na platný proces nebo jiné selhání.

Poznámky

Tato funkce přijímá proces CLR identifikovaný pidDebuggee řetězcem a cestu k řetězci, která je určena szModuleName. Řetězec verze se vrátí do vyrovnávací paměti, na kterou pBuffer odkazuje. Tento řetězec je neprůhlený pro uživatele funkce; to znamená, že samotný řetězec verze nemá žádný vnitřní význam. Používá se výhradně v kontextu této funkce a CreateDebuggingInterfaceFromVersion funkce.

Tato funkce by měla být volána dvakrát. Při prvním volání předejte hodnotu null pro obě pBuffer a cchBuffer. Když to uděláte, velikost vyrovnávací paměti potřebné pro pBuffer bude vrácena v pdwLength. Pak můžete funkci volat podruhé a předat vyrovnávací paměť pBuffer a její velikost v cchBuffer.

Požadavky

Platformy: Viz podporované operační systémy .NET.

Hlavička: dbgshim.h

Knihovna: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Verze .NET: Dostupné od .NET Core 2.1

Sdílet prostřednictvím