Funzione CreateVersionStringFromModuleCreateVersionStringFromModule Function

Crea una stringa di versione da un percorso Common Language Runtime (CLR) in un processo di destinazione.Creates a version string from a common language runtime (CLR) path in a target process.

SintassiSyntax

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

ParametriParameters

pidDebuggee
[in] Identificatore del processo nel quale è caricato il CLR di destinazione.[in] Identifier of the process in which the target CLR is loaded.

szModuleName
[in] Percorso completo o relativo del CLR di destinazione caricato nel processo.[in] Full or relative path to the target CLR that is loaded in the process.

pBuffer
[out] Buffer di ritorno per l'archiviazione delle stringhe di versione per il CLR di destinazione.[out] Return buffer for storing the version string for the target CLR.

cchBuffer
[in] Dimensione di pBuffer.[in] Size of pBuffer.

pdwLength
[out] Lunghezza della stringa di versione restituita da pBuffer.[out] Length of the version string returned by pBuffer.

Valore restituitoReturn Value

S_OKS_OK
La stringa della versione per il CLR di destinazione è stata correttamente restituita in pBuffer.The version string for the target CLR was successfully returned in pBuffer.

E_INVALIDARGE_INVALIDARG
szModuleName è null oppure either pBuffer o cchBuffer è null.szModuleName is null, or either pBuffer or cchBuffer is null. pBuffer e cchBuffer devono entrambi essere null o non Null.pBuffer and cchBuffer must both be null or non-null.

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
pdwLength è maggiore di cchBuffer.pdwLength is greater than 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.This may be an expected result if you have passed null for both pBuffer and cchBuffer, and queried the necessary buffer size by using pdwLength.

HRESULT_FROM_WIN32(ERROR_MOD_NOT_FOUND)HRESULT_FROM_WIN32(ERROR_MOD_NOT_FOUND)
szModuleName on contiene un percorso a un CLR valido nel processo di destinazione.szModuleName does not contain a path to a valid CLR in the target process.

E_FAIL (o altri codici E_ restituiti)E_FAIL (or other E_ return codes)
pidDebuggee non fa riferimento a un processo valido o a altri errori.pidDebuggee does not refer to a valid process, or other failure.

NoteRemarks

Questa funzione accetta un processo di CLR identificato da pidDebuggee e un percorso della stringa specificato da szModuleName.This function accepts a CLR process that is identified by pidDebuggee and a string path that is specified by szModuleName. La stringa della versione viene restituita nel buffer al quale puntapBuffer.The version string is returned in the buffer that pBuffer points to. Questa stringa è invisibile all'utente della funzione. In altre parole, non è presente alcun significato intrinseco nella stringa di versione stessa.This string is opaque to the function user; that is, there is no intrinsic meaning in the version string itself. Viene utilizzato esclusivamente nel contesto di questa funzione e funzione CreateDebuggingInterfaceFromVersion.It is used solely in the context of this function and the CreateDebuggingInterfaceFromVersion function.

Questa funzione deve essere chiamata due volte.This function should be called twice. Quando si chiama per la prima volta, passare il valore null per pBuffer e cchBuffer.When you call it the first time, pass null for both pBuffer and cchBuffer. Quando si esegue questa operazione, le dimensioni del buffer necessarie per pBuffer verranno restituite in pdwLength.When you do this, the size of the buffer necessary for pBuffer will be returned in pdwLength. È possibile, quindi, chiamare la funzione una seconda volta e passare il buffer in pBuffer e le sue dimensioni in cchBuffer.You can then call the function a second time, and pass the buffer in pBuffer and its size in cchBuffer.

RequisitiRequirements

Piattaforme: vedere requisiti di sistema.Platforms: See System Requirements.

Intestazione: dbgshim. hHeader: dbgshim.h

Libreria: dbgshim. dllLibrary: dbgshim.dll

Versioni di .NET framework: 3.5 SP1.NET Framework Versions: 3.5 SP1