ICorDebugMetaDataLocator::GetMetaData (Método)

Artículo
08/10/2011

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.

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 (nombreDeArchivo.extensión).
dwImageTimeStamp
[in] Marca de tiempo de los encabezados de archivo PE de la imagen. Este parámetro se puede usar para una búsqueda en un servidor de símbolos (SymSrv).
dwImageSize
[in] Tamaño de imagen de los encabezados de archivo PE. Este parámetro se puede usar para una búsqueda de SymSrv.
cchPathBuffer
[in] Número de caracteres de wszPathBuffer.
pcchPathBuffer
[out] Número de WCHAR 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 de este archivo.

Valor devuelto

Este método devuelve los siguientes HRESULT específicos, así como errores HRESULT que indican la existencia de un error en el método. Todos los demás HRESULT de error indican que el archivo no es recuperable.

HRESULT	Descripción
S_OK	El método se ha ejecutado 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 almacenar la ruta de acceso completa. En este caso, pcchPathBuffer contiene el número necesario de WCHAR, incluyendo el carácter null de terminación, y se llama a GetMetaData por 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 donde se recopiló el volcado. Puede que el archivo no exista en esta ubicación o que haya un archivo incorrecto con el mismo nombre almacenado en la ruta de acceso.