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

Artículo
02/26/2024

El método GetUlong 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 GetUlong(
  [in]  FA_TAG Tag,
  [out] PULONG Value
);

Parámetros

[in] Tag

Valor de la enumeración FA_TAG .

[out] Value

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

Valor devuelto

Si este método encuentra una entrada fa 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.

Comentarios

Este método copia una cadena terminada en null desde el 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.