ICorDebugMetaDataLocator::GetMetaData (Método)
Pide al depurador que devuelva la ruta de acceso completa a un módulo cuyos metadatos se necesitan para completar una operación solicitada por el depurador.
Sintaxis
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[]
);
Parámetros
wszImagePath [in] Cadena terminada en NULL que representa la ruta de acceso completa al archivo. Si la ruta de acceso completa no está disponible, el nombre y la extensión del archivo (nombre de archivo.extensión).
dwImageTimeStamp [in] Marca de tiempo de los encabezados de archivo PE de la imagen. Este parámetro puede utilizarse potencialmente para una búsqueda en el servidor de símbolos (SymSrv).
dwImageSize [in] Tamaño de imagen de los encabezados de archivo PE. Este parámetro podría usarse para una búsqueda de SymSrv.
cchPathBuffer [in] Recuento de caracteres en wszPathBuffer.
pcchPathBuffer [out] Recuento de WCHARs escritos en wszPathBuffer.
Si el método devuelve E_NOT_SUFFICIENT_BUFFER, contiene el número de WCHAR necesarios para almacenar la ruta de acceso.
wszPathBuffer [out] Puntero a un búfer en el que el depurador copiará la ruta de acceso completa del archivo que contiene los metadatos solicitados.
La marca ofReadOnly de la enumeración CorOpenFlags se usa para solicitar acceso de solo lectura a los metadatos en este archivo.
Valor devuelto
Este método devuelve los siguientes HRESULT específicos y los errores HRESULT que indican un error del método. Cualquier otro HRESULT de error indica que el archivo no se puede recuperar.
| HRESULT | Descripción |
|---|---|
| S_OK | El método se completó correctamente. wszPathBuffer contiene la ruta de acceso completa al archivo y termina en NULL. |
| E_NOT_SUFFICIENT_BUFFER | El tamaño actual de wszPathBuffer no es suficiente para contener la ruta de acceso completa. En este caso, pcchPathBuffer contiene el número necesario de WCHAR, incluido el carácter NULL final, y se llama a GetMetaData una segunda vez con el tamaño de búfer solicitado. |
Comentarios
Si wszImagePath contiene una ruta de acceso completa para un módulo de un volcado de memoria, especifica la ruta de acceso del equipo desde el que se recopiló el volcado de memoria. Puede que el archivo no exista en esta ubicación o que en ella haya almacenado un archivo incorrecto con el mismo nombre.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: CorDebug.idl, CorDebug.h
Biblioteca: CorGuids.lib
Versiones de .NET Framework: disponible a partir de la versión 4
