Funzione CreateVersionStringFromModule

Crea una stringa di versione da un percorso CLR (Common Language Runtime) 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 in cui viene caricato CLR di destinazione.

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

pBuffer
[out] Buffer restituito per l'archiviazione della stringa di versione per CLR di destinazione.

cchBuffer
[in] Dimensioni di pBuffer.

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

Valore restituito

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

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

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
pdwLength è maggiore di cchBuffer. Può trattarsi di un risultato previsto se è stato passato null per e pBuffercchBuffered è stata eseguita una query sulle dimensioni del buffer necessarie usando pdwLength.

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

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

Osservazioni:

Questa funzione accetta un processo CLR identificato da pidDebuggee e un percorso stringa specificato da szModuleName. La stringa di versione viene restituita nel buffer a cui pBuffer punta. Questa stringa è opaca per l'utente della funzione; ovvero, non esiste 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 viene chiamato per la prima volta, passare null sia per che pBufferper cchBuffer . Quando si esegue questa operazione, le dimensioni del buffer necessario per pBuffer verranno restituite in pdwLength. È quindi possibile chiamare la funzione una seconda volta e passare il buffer in pBuffer e le relative dimensioni in cchBuffer.

Requisiti

Piattaforme: Vedere Sistemi operativi supportati da .NET.

Intestazione: dbgshim.h

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

Versioni di .NET: Disponibile a partire da .NET Core 2.1