CreateVersionStringFromModule-Funktion

Erstellt eine Versionszeichenfolge aus einem CLR-Pfad (Common Language Runtime) in einem Zielprozess.

Syntax

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

Die Parameter

pidDebuggee
[in] Bezeichner des Prozesses, in dem die Ziel-CLR geladen wird.

szModuleName
[in] Vollständiger oder relativer Pfad zu der Ziel-CLR, die im Prozess geladen wird.

pBuffer
[out] Rückgabepuffer zum Speichern der Versionszeichenfolge für die Ziel-CLR.

cchBuffer
[in] Größe von pBuffer.

pdwLength
[out] Länge der von pBuffer.

Rückgabewert

S_OK
Die Versionszeichenfolge für die Ziel-CLR wurde erfolgreich zurückgegeben.pBuffer

E_INVALIDARG
szModuleName ist null oder pBuffercchBuffer ist null. pBuffer und cchBuffer muss null oder ungleich Null sein.

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
pdwLength ist größer als cchBuffer. Dies kann ein erwartetes Ergebnis sein, wenn Sie null für beide pBuffer und cchBufferabgefragt und die erforderliche Puffergröße mithilfe der Verwendung pdwLengthabgefragt haben.

HRESULT_FROM_WIN32(ERROR_MOD_NOT_FOUND)
szModuleName enthält keinen Pfad zu einem gültigen CLR im Zielprozess.

E_FAIL (oder andere E_ Rückgabecodes)
pidDebuggee bezieht sich nicht auf einen gültigen Prozess oder auf einen anderen Fehler.

Bemerkungen

Diese Funktion akzeptiert einen CLR-Prozess, der durch pidDebuggee einen durch angegebenen Zeichenfolgenpfad identifiziert szModuleNamewird. Die Versionszeichenfolge wird im Puffer zurückgegeben, pBuffer auf den verweist. Diese Zeichenfolge ist für den Funktionsbenutzer nicht transparent; d. h., es gibt keine systeminterne Bedeutung in der Versionszeichenfolge selbst. Sie wird ausschließlich im Kontext dieser Funktion und der CreateDebuggingInterfaceFromVersion-Funktion verwendet.

Diese Funktion sollte zweimal aufgerufen werden. Wenn Sie es zum ersten Mal aufrufen, übergeben Sie NULL für beide pBuffer und cchBuffer. Wenn Sie dies tun, wird die Größe des puffers zurückgegebenpBuffer, der erforderlich pdwLength ist. Anschließend können Sie die Funktion ein zweites Mal aufrufen und den Puffer in pBuffer und dessen Größe cchBufferübergeben.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Header: dbgshim.h

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

.NET-Versionen: Verfügbar seit .NET Core 2.1