Méthode IAnalysisWarning::GetNodeIds

Retourne les identificateurs de tous les nœuds de contexte pertinents associés à cet avertissement.

Syntaxe

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

Paramètres

pulCount [in, out]

Nombre d’identificateurs globaux uniques (GUID) dans ppNodeIds.

ppNodeIds [out]

Pointeur vers un tableau de GUID qui identifie les nœuds de contexte associés à cet avertissement d’analyse, ou NULL si aucun nœud de contexte n’est associé à l’avertissement.

Valeur retournée

Pour obtenir une description des valeurs renvoyées, consultez Classes et interfaces - Analyse de l’entrée manuscrite.

Notes

Si ppNodeIds est passé en tant que NULL, la méthode GetNodeIds retourne S_OK et le nombre de rectangles est retourné dans pulCount.

Attention

Pour éviter une fuite de mémoire, utilisez CoTaskMemFree pour libérer la mémoire de *ppNodeIds lorsque vous n’avez plus besoin des informations.

Exemples

L’exemple suivant montre comment obtenir les objets IContextNode qui se trouvent dans IAnalysisWarning, warninget comment obtenir uniquement le nombre d’objets 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); 

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
En-tête	IACom.h (nécessite également IACom_i.c)
DLL	IACom.dll

Voir aussi

IAnalysisWarning

IContextNode

IInkAnalyzer::FindNode, méthode

Informations de référence sur l’analyse de l’encre