Compartilhar via


Método IAnalysisWarning::GetNodeIds

Retorna os identificadores de quaisquer nós de contexto relevantes associados a esse aviso.

Sintaxe

HRESULT GetNodeIds(
  [in, out] ULONG *pulCount,
  [out]     GUID  **ppNodeIds
);

Parâmetros

pulCount [in, out]

O número de GUIDs (identificadores globalmente exclusivos) em ppNodeIds.

ppNodeIds [out]

Um ponteiro para uma matriz de GUIDs que identifica os nós de contexto associados a esse aviso de análise ou NULL se nenhum nó de contexto estiver associado ao aviso.

Valor retornado

Para obter uma descrição dos valores retornados, consulte Classes e interfaces – Análise de tinta.

Comentários

Se ppNodeIds for passado como NULL, o método GetNodeIds retornará S_OK e o número de retângulos será retornado em pulCount.

Cuidado

Para evitar uma perda de memória, use CoTaskMemFree para liberar a memória de *ppNodeIds quando você não precisar mais das informações.

Exemplos

O exemplo a seguir mostra como obter os objetos IContextNode que estão no IAnalysisWarning, warninge como obter apenas o número de objetos IContextNode

// Get the count of the context nodes and their identifiers.
ULONG count = 0;
GUID* nodeIds = 0;
warning->GetNodeIds(&count, &nodeIds);

// Use nodeIds

::CoTaskMemFree(nodeIds);

// GetNodeIds just gets the count and returns S_OK
ULONG number = 0;
warning->GetNodeIds(&number, NULL); 

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Nenhum compatível
Cabeçalho
IACom.h (também requer IACom_i.c)
DLL
IACom.dll

Confira também

IAnalysisWarning

IContextNode

Método IInkAnalyzer::FindNode

Referência de análise de tinta