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

El método FindTypeByName busca un tipo definido en el módulo por el nombre del 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 recursividad explícita de 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 aparece 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.

Observaciones

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

   
Header dbgmodel.h

Vea también

Interfaz IDebugHostModule2