Funzione CreateVersionStringFromModule

Articolo
09/22/2023

Crea una stringa di versione da un percorso Common Language Runtime (CLR) in un processo di destinazione.

Sintassi

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

Parametri

pidDebuggee
[in] Identificatore del processo nel quale è caricato il CLR di destinazione.

szModuleName
[in] Percorso completo o relativo del CLR di destinazione caricato nel processo.

pBuffer
[out] Buffer di ritorno per l'archiviazione delle stringhe di versione per il CLR di destinazione.

cchBuffer
[in] Dimensione di pBuffer.

pdwLength
[out] Lunghezza della stringa di versione restituita da pBuffer.

Valore restituito

S_OK
La stringa della versione per il CLR di destinazione è stata correttamente restituita in pBuffer.

E_INVALIDARG
szModuleName è null oppure either pBuffer o cchBuffer è null. pBuffer e cchBuffer devono entrambi essere null o non Null.

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
pdwLength è maggiore di cchBuffer. Può trattarsi di un risultato previsto se è stato passato un valore Null per entrambi gli elementi pBuffer e cchBuffer e se è stata eseguita una query sulle dimensioni del buffer necessarie tramite pdwLength.

HRESULT_FROM_WIN32(ERROR_MOD_NOT_FOUND)
szModuleName on contiene un percorso a un CLR valido nel processo di destinazione.

E_FAIL (o altri codici E_ restituiti)
pidDebuggee non fa riferimento a un processo valido o a altri errori.

Osservazioni:

Questa funzione accetta un processo di CLR identificato da pidDebuggee e un percorso della stringa specificato da szModuleName. La stringa della versione viene restituita nel buffer al quale puntapBuffer. Questa stringa è invisibile all'utente della funzione. In altre parole, non è presente alcun significato intrinseco nella stringa di versione stessa. Viene usato esclusivamente nel contesto di questa funzione e nella funzione CreateDebuggingInterfaceFromVersion.

Questa funzione deve essere chiamata due volte. Quando si chiama per la prima volta, passare il valore null per pBuffer e cchBuffer. Quando si esegue questa operazione, le dimensioni del buffer necessarie per pBuffer verranno restituite in pdwLength. È possibile, quindi, chiamare la funzione una seconda volta e passare il buffer in pBuffer e le sue dimensioni in cchBuffer.

Requisiti

Piattaforme: vedere Sistemi operativi supportati da .NET.

Intestazione: dbgshim.h

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

Versioni .NET: disponibili a partire da .NET Core 2.1

Condividi tramite