IAnalysisWarning :: GetNodeIds, méthode

Retourne les identificateurs de tous les nœuds de contexte appropriés 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 [ à]

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 de retour

Pour obtenir une description des valeurs de retour, consultez classes et interfaces-analysede l’encre.

Notes

Si ppNodeIds est passé comme 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 à partir de * ppNodeIds lorsque vous n’avez plus besoin des informations.

Exemples

L’exemple suivant montre comment récupérer les objets IContextNode qui se trouvent dans le IAnalysisWarning, warning et comment récupérer 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 Applications de bureau XP Édition Tablet PC [ 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

Référence de l’analyse de l’encre