Compartir a través de


Método IDebugHostModule2::FindTypeByName (dbgmodel.h)

El método FindTypeByName busca un tipo definido en el módulo por el nombre de tipo y devuelve un símbolo de tipo para él. Este método puede devolver un IDebugHostType válido que nunca se devolvería a través de la recursividad explícita de los elementos secundarios del módulo. El host de depuración puede permitir la creación de tipos derivados: tipos que no se usan nunca dentro del propio módulo, sino derivados de tipos que son. Por ejemplo, si la estructura MyStruct se define en los símbolos del módulo, pero el tipo MyStruct ** nunca se usa, el método FindTypeByName puede devolver legítimamente un símbolo de tipo para MyStruct ** a pesar de que ese nombre de tipo nunca aparezca explícitamente en los símbolos del módulo.

Muchos hosts de depuración realizarán un intento explícito de contextualizar el nombre de tipo que se pasa al método FindTypeByName y buscarán un tipo coincidente dentro de la información simbólica según las reglas del lenguaje y no una comparación sin procesar con los nombres de símbolos. En caso de que un host de depuración no pueda hacerlo, volverá a la comparación sin procesar con los nombres de símbolos.

Sintaxis

HRESULT FindTypeByName(
  PCWSTR         typeName,
  IDebugHostType **type
);

Parámetros

typeName

Tipo de idioma que se va a buscar en la información simbólica del módulo. El tipo también se puede derivar de (por ejemplo, ser un puntero a o una matriz de) un tipo que se encuentra en la información simbólica del módulo.

type

Aquí se devolverá un símbolo de tipo para el tipo encontrado.

Valor devuelto

Este método devuelve HRESULT, que indica que se ha realizado correctamente o no.

Comentarios

Código de ejemplo

ComPtr<IDebugHostModule> spModule; /* get a module (see FindModuleByName) */

// Find "MyStruct **".  Note that only "MyStruct" might be in the symbols
ComPtr<IDebugHostType> spType;
if (SUCCEEDED(spModule->FindTypeByName(L"MyStruct **", &spType)))
{
    // spType contains a type symbol for "MyStruct **"
}

Requisitos

Requisito Valor
Header dbgmodel.h

Consulte también

Interfaz IDebugHostModule2