CreateVersionStringFromModule – funkce pro Silverlight

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.

Návratová 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 požadavky na systém.

Hlavička: dbgshim.h

Knihovna: dbgshim.dll

Verze rozhraní .NET Framework: 3.5 SP1