Método IDebugFailureAnalysis2::SetString (extsfns.h)
El método SetString busca en un objeto DebugFailureAnalysis la primera entrada 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 una entrada fa que tenga 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 nueva o existente.
Valor devuelto
Si este método se ejecuta correctamente, devuelve un puntero a la estructura de FA_ENTRY nueva o existente. De lo contrario, devuelve NULL.
Comentarios
Si este método encuentra una entrada 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 fa con la etiqueta especificada, crea una nueva entrada fa con esa etiqueta y asocia la etiqueta al tipo de datos DEBUG_FA_ENTRY_ANSI_STRING.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | extsfns.h |
Consulte también
Escribir un complemento de extensión de análisis para ampliar !analyze