Método IDebugFAEntryTags::GetProperties (extsfns.h)

El método GetProperties obtiene el nombre o la descripción (o ambos) de una etiqueta en un objeto DebugFailureAnalysisTags .

Sintaxis

HRESULT GetProperties(
            FA_TAG Tag,
  [out]     PSTR   Name,
  [in, out] PULONG NameSize,
  [out]     PSTR   Description,
  [in, out] PULONG DescSize,
  [out]     PULONG Flags
);

Parámetros

Tag

Valor de la enumeración FA_TAG . Este método obtiene el nombre o la descripción (o ambos) de esta etiqueta.

[out] Name

Puntero a un búfer que recibe una cadena terminada en NULL que es el nombre de la etiqueta. Si NameSize es menor que la longitud del nombre de la etiqueta, este método copia solo los bytes NameSize , incluido el terminador NULL , en este búfer.

[in, out] NameSize

En la entrada, este parámetro especifica el tamaño, en bytes, del búfer al que apunta Name. En la salida, este parámetro recibe el tamaño, en bytes, del nombre de la etiqueta. Si la etiqueta no tiene nombre, este parámetro recibe un valor de 0.

Nota Si Name es NULL, este parámetro no recibe información. Debe establecer Name y NameSize en valores que no sean NULL o establecerlos en NULL.

 

[out] Description

Puntero a un búfer que recibe una cadena terminada en null que es la descripción de la etiqueta. Si DescSize es menor que la longitud de la descripción de la etiqueta, este método copia solo bytes de DescSize , incluido el terminador NULL , en este búfer.

[in, out] DescSize

En la entrada, este parámetro especifica el tamaño, en bytes, del búfer al que apunta Description. En la salida, este parámetro recibe el tamaño, en bytes, de la descripción de la etiqueta. Si la etiqueta no tiene ninguna descripción, este parámetro recibe un valor de 0.

Nota Si Description es NULL, este parámetro no recibe información. Debe establecer Description y DescSize en valores que no sean NULL o establecerlos en NULL.

 

[out] Flags

Reservado. Establezca este parámetro en NULL.

Valor devuelto

Los valores HRESULT devueltos por este método se definen en winerror.h y strsafe.h. Los valores devueltos por este método incluyen, pero no se limitan a lo siguiente:

Código devuelto	Descripción
S_OK	Este método recuperó correctamente el nombre o la descripción solicitados (o ambos) y no se requería ningún truncamiento de la cadena o cadenas solicitadas.
STRSAFE_E_INSUFFICIENT_BUFFER	Este método recuperó el nombre o la descripción solicitados (o ambos), pero el nombre o la descripción se truncaron.
STRSAFE_E_INVALID_PARAMETER	El autor de la llamada pasó al menos un parámetro no válido.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	extsfns.h

Consulte también

IDebugFAEntryTags

IDebugFailureAnalysis2

SetProperties

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

_EFN_Analyze