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

Artículo
02/29/2024

El método GetString busca en un objeto DebugFailureAnalysis 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 una entrada fa con la etiqueta especificada y, si se realiza correctamente al obtener el bloque de datos, devuelve un puntero a la estructura FA_ENTRY . De lo contrario, devuelve NULL.

Comentarios

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 MaxSize , incluido el terminador NULL.

Cada etiqueta que ya se ha usado en un objeto DebugFailureAnalysis está asociada 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 . Para obtener un puntero a una interfaz IDebugFAEntryTags, llame al método GetDebugFATagControl de la interfaz IDebugFailureAnalysis2 .

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