Compartir vía

ICorDebugMetaDataLocator::GetMetaData (Método)

Pide al depurador que devuelva la ruta de acceso completa a un módulo cuyos metadatos son necesarios para completar una operación solicitada por el depurador.

Syntax

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 usarse potencialmente para una búsqueda de servidor de símbolos (SymSrv).

dwImageSize [in] Tamaño de imagen de los encabezados de archivo PE. Este parámetro puede usarse potencialmente para una búsqueda 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 recuento de WCHARs 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 ofReadOnly marca de la enumeración CorOpenFlags se usa para solicitar acceso de solo lectura a los metadatos de este archivo.

Valor devuelto

Este método devuelve los siguientes HRESULT específicos, así como los errores HRESULT que indican el error del método. Todos los demás HRESULT de error indican que el archivo no se puede recuperar.

HRESULT Description
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 recuento necesario de WCHARs, incluido el carácter nulo de terminación, y GetMetaData se llama una segunda vez con el tamaño de búfer solicitado.

Observaciones

Si wszImagePath contiene una ruta de acceso completa para un módulo desde un volcado de memoria, especifica la ruta de acceso desde el equipo donde se recopiló el volcado. Es posible que el archivo no exista en esta ubicación o que se almacene un archivo incorrecto con el mismo nombre en la ruta de acceso.

Requisitos

Plataformas: Consulte Sistemas operativos compatibles con .NET.

Encabezado: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versiones de .NET: Disponible desde .NET Framework 4.0

Consulte también

  • Last updated on