Método IDebugFailureAnalysis::GetString (extsfns.h)

El método GetString busca un objeto DebugFailureAnalysis para la primera entrada FA que tiene una etiqueta especificada. Si encuentra una entrada fa con la etiqueta especificada, obtiene el valor de cadena ANSI del bloque de datos de la entrada.

Sintaxis

PFA_ENTRY GetString(
  [in]  FA_TAG Tag,
  [out] PSTR   Str,
  [in]  ULONG  MaxSize
);

Parámetros

[in] Tag

Valor de la enumeración FA_TAG.

[out] Str

Puntero a un búfer que recibe el valor de cadena del bloque de datos de la entrada.

[in] MaxSize

Tamaño, en bytes, del búfer al que apunta Str.

Valor devuelto

Si este método encuentra un de entrada fa de con la etiqueta especificada y, si se ejecuta correctamente en la obtención del bloque de datos, devuelve un puntero a la estructura FA_ENTRY. De lo contrario, devuelve NULL.

Observaciones

Este método copia una cadena terminada en null del bloque de datos de la entrada al búfer al que apunta Str. Este método copia como máximo caracteres de MaxSize, incluido el terminador NULL.

Cada etiqueta que ya se ha usado en un objeto de DebugFailureAnalysis está asociado a uno de los tipos de datos de la enumeración FA_ENTRY_TYPE. Para determinar el tipo de datos asociado a una etiqueta, llame al método GetType de la interfaz IDebugFAEntryTags de. Para obtener un puntero a una interfaz IDebugFAEntryTags, llame al método GetDebugFATagControl de la interfaz IDebugFailureAnalysis 2.

El uso adecuado de este método es obtener el bloque de datos de una entrada fa de que tiene un tipo de datos de DEBUG_FA_ENTRY_ANSI_STRING.

Requisitos

Consulte también

addString

IDebugFailureAnalysis2

SetString

escribir un complemento de extensión de análisis para ampliar !analyze

_EFN_Analyze