Método IDebugFailureAnalysis2::SetString (extsfns.h)

Artículo
02/06/2025

El método SetString busca un objeto DebugFailureAnalysis para la primera entrada de FA que tiene una etiqueta especificada. Si encuentra una entrada fa con la etiqueta especificada, establece (sobrescribe) el bloque de datos de la entrada fa en un valor de cadena especificado. Si este método no encuentra un entrada FA que tiene la etiqueta especificada, crea una nueva entrada fa con esa etiqueta y establece el bloque de datos de la nueva entrada fa en el valor de cadena especificado.

Sintaxis

PFA_ENTRY SetString(
       FA_TAG Tag,
  [in] PCSTR  Str
);

Parámetros

Tag

Valor de la enumeración FA_TAG.

[in] Str

Puntero a una cadena ANSI terminada en null que se va a escribir en el bloque de datos de la entrada fa de nueva o existente.

Valor devuelto

Si este método se realiza correctamente, devuelve un puntero a la estructura de FA_ENTRY nueva o existente. De lo contrario, devuelve NULL.

Observaciones

Si este método encuentra una entrada de FA con la etiqueta especificada, comprueba si el tipo de datos asociado a esa etiqueta es DEBUG_FA_ENTRY_ANSI_STRING o DEBUG_FA_ENTRY_EXTENSION_CMD. Si el tipo de datos asociado a la etiqueta no es uno de esos dos tipos, este método devuelve NULL y no sobrescribe el bloque de datos de la entrada.

Si este método no encuentra una entrada de FA con la etiqueta especificada, crea una nueva entrada fa con esa etiqueta y asocia la etiqueta con el tipo de datos DEBUG_FA_ENTRY_ANSI_STRING.