Metodo ICorDebugMetaDataLocator::GetMetaData

Articolo
11/05/2024

Chiede al debugger di restituire il percorso completo di un modulo i cui metadati sono necessari per completare un'operazione richiesta dal debugger.

Sintassi

HRESULT GetMetaData(
      [in] LPCWSTR wszImagePath,
      [in] DWORD   dwImageTimeStamp,
      [in] DWORD   dwImageSize,
      [in] ULONG32 cchPathBuffer,
      [out] ULONG32 * pcchPathBuffer,
      [out, size_is(cchPathBuffer), length_is(*pcchPathBuffer)]
               WCHAR wszPathBuffer[]
      );

Parametri

wszImagePath [in] Stringa con terminazione Null che rappresenta il percorso completo del file. Se il percorso completo non è disponibile, il nome e l'estensione del file (nome file.estensione).

dwImageTimeStamp [in] Timestamp delle intestazioni del file PE dell'immagine. Questo parametro può essere usato potenzialmente per la ricerca di un server di simboli (SymSrv).

dwImageSize [in] Dimensioni dell'immagine dalle intestazioni di file PE. Questo parametro può essere potenzialmente usato per una ricerca in SymSrv.

cchPathBuffer [in] Numero di caratteri in wszPathBuffer.

pcchPathBuffer [out] Conteggio degli WCHARoggetti scritti in wszPathBuffer.

Se il metodo restituisce E_NOT_SUFFICIENT_BUFFER, contiene il numero di WCHAR necessario per archiviare il percorso.

wszPathBuffer [out] Puntatore a un buffer in cui il debugger copia il percorso completo del file che contiene i metadati richiesti.

Il ofReadOnly flag dell'enumerazione CorOpenFlags viene usato per richiedere l'accesso in sola lettura ai metadati in questo file.

Valore restituito

Questo metodo restituisce gli specifici HRESULT seguenti, nonché gli errori di HRESULT che indicano la mancata riuscita del metodo. Tutti gli altri HRESULT di errore indicano che il file non è recuperabile.

HRESULT	Descrizione
S_OK	Metodo completato correttamente. `wszPathBuffer` contiene il percorso completo del file ed è con terminazione null.
E_NOT_SUFFICIENT_BUFFER	Le dimensioni correnti di `wszPathBuffer` non sono sufficienti a contenere il percorso completo. In questo caso, `pcchPathBuffer` contiene il numero necessario di `WCHAR`s, incluso il carattere di terminazione null e `GetMetaData` viene chiamato una seconda volta con le dimensioni del buffer richiesto.

Osservazioni:

Se wszImagePath contiene un percorso completo di un modulo da un dump, specifica il percorso dal computer in cui è stato recuperato il dump. Il file può non esistere in questa posizione oppure un file errato con lo stesso nome può essere archiviato nel percorso.

Requisiti

Piattaforme: vedere Requisiti di sistema.

Intestazione: CorDebug.idl, CorDebug.h

Libreria: CorGuids.lib

Versioni di .NET Framework: disponibili dalla versione 4

Condividi tramite