CreateVersionStringFromModule függvény

Létrehoz egy verziósztringet egy közös nyelvi futtatókörnyezeti (CLR) elérési útból egy célfolyamatban.

Szemantika

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

Paraméterek

pidDebuggee
[in] Annak a folyamatnak az azonosítója, amelyben a cél CLR betöltődik.

szModuleName
[in] A folyamatban betöltött cél CLR teljes vagy relatív elérési útja.

pBuffer
[kifelé] Visszatérési puffer a cél CLR verziósztringjének tárolásához.

cchBuffer
[in] A méret .pBuffer

pdwLength
[kifelé] A visszaadott pBufferverziósztring hossza.

Visszaadott érték

S_OK
A cél CLR verziósztringje sikeresen vissza lett adva a következőben pBuffer: .

E_INVALIDARG
szModuleName értéke null, vagy pBuffercchBuffer vagy null. pBuffer és cchBuffer mindkettőnek null vagy nem null értékűnek kell lennie.

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
pdwLength nagyobb, mint cchBuffer. Ez várható eredmény lehet, ha a null értéket adta meg mindkét pBuffer értékre, és cchBufferlekérdezte a szükséges pufferméretet a használatával pdwLength.

HRESULT_FROM_WIN32(ERROR_MOD_NOT_FOUND)
szModuleName nem tartalmaz érvényes CLR elérési útját a célfolyamatban.

E_FAIL (vagy egyéb E_ visszatérési kódok)
pidDebuggee nem hivatkozik érvényes folyamatra vagy egyéb hibára.

Megjegyzések

Ez a függvény egy CLR-folyamatot fogad el, amelyet pidDebuggee a megadott karakterlánc-elérési út szModuleNameazonosít. A rendszer visszaadja a verziósztringet a pufferben, amely pBuffer a gombra mutat. Ez a sztring átlátszatlan a függvényfelhasználó számára; vagyis magának a verziósztringnek nincs belső jelentése. Kizárólag a függvény és a CreateDebuggingInterfaceFromVersion függvény kontextusában használható.

Ezt a függvényt kétszer kell meghívni. Amikor első alkalommal hívja meg, adjon meg null értéket mindkét pBuffer és cchBuffer. Ha ezt teszi, a puffer szükséges pBuffer mérete lesz visszaadva a következőben pdwLength: . Ezután meghívhatja a függvényt másodszor is, és átadhatja a puffert pBuffer és annak méretét a következőben cchBuffer: .

Követelmények

Platformok: Lásd: .NET által támogatott operációs rendszerek.

Fejléc: dbgshim.h

Könyvtár: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

.NET-verziók: A .NET Core 2.1 óta érhető el