Funzione CreateVersionStringFromModule per Silverlight

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 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 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 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 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 Requisiti di sistema.

Intestazione: dbgshim.h

Libreria: dbgshim.dll

Versioni di .NET Framework: 3.5 SP1