Funktionen CreateVersionStringFromModule

Artikel
03/02/2024

Skapar en versionssträng från en CLR-sökväg (Common Language Runtime) i en målprocess.

Syntax

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

Parametrar

pidDebuggee
[i] Identifierare för den process där mål-CLR läses in.

szModuleName
[i] Fullständig eller relativ sökväg till mål-CLR som läses in i processen.

pBuffer
[ut] Returnera buffert för lagring av versionssträngen för mål-CLR.

cchBuffer
[i] Storleken på pBuffer.

pdwLength
[ut] Längden på versionssträngen som returneras av pBuffer.

Returvärde

S_OK
Versionssträngen för mål-CLR returnerades i pBuffer.

E_INVALIDARG
szModuleName är null, eller antingen pBuffer eller cchBuffer är null. pBuffer och cchBuffer måste båda vara null eller icke-null.

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
pdwLength är större än cchBuffer. Detta kan vara ett förväntat resultat om du har skickat null för både pBuffer och cchBuffer, och efterfrågat den nödvändiga buffertstorleken med hjälp pdwLengthav .

HRESULT_FROM_WIN32(ERROR_MOD_NOT_FOUND)
szModuleName innehåller inte en sökväg till en giltig CLR i målprocessen.

E_FAIL (eller andra E_ returkoder)
pidDebuggee refererar inte till en giltig process eller något annat fel.

Kommentarer

Den här funktionen accepterar en CLR-process som identifieras av pidDebuggee och en strängsökväg som anges av szModuleName. Versionssträngen returneras i bufferten som pBuffer pekar på. Den här strängen är ogenomskinlig för funktionsanvändaren. det vill säga att det inte finns någon inbyggd betydelse i själva versionssträngen. Den används enbart i kontexten för den här funktionen och funktionen CreateDebuggingInterfaceFromVersion.

Den här funktionen bör anropas två gånger. När du anropar det första gången skickar du null för både pBuffer och cchBuffer. När du gör detta returneras storleken på bufferten som krävs för pBuffer i pdwLength. Du kan sedan anropa funktionen en andra gång och skicka bufferten i pBuffer och dess storlek i cchBuffer.

Behov

Plattformar: Se operativsystem som stöds av .NET.

Rubrik: dbgshim.h

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

.NET-versioner: Finns sedan .NET Core 2.1

Dela via