IAnalysisWarning::GetNodeIds-Methode

Gibt die Bezeichner aller relevanten Kontextknoten zurück, die dieser Warnung zugeordnet sind.

Syntax

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

Parameter

pulCount [in, out]

Die Anzahl von GUIDs (Globally Unique Identifiers) in ppNodeIds.

ppNodeIds [out]

Ein Zeiger auf ein Array von GUIDs, das die Kontextknoten identifiziert, die dieser Analysewarnung zugeordnet sind, oder NULL , wenn der Warnung keine Kontextknoten zugeordnet sind.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Freihandanalyse.

Bemerkungen

Wenn ppNodeIds als NULL übergeben wird, gibt die GetNodeIds-MethodeS_OK zurück, und die Anzahl der Rechtecke wird in pulCount zurückgegeben.

Achtung

Um einen Speicherverlust zu vermeiden, verwenden Sie CoTaskMemFree , um den Arbeitsspeicher aus *ppNodeIds freizugeben, wenn Sie die Informationen nicht mehr benötigen.

Beispiele

Das folgende Beispiel zeigt, wie Sie die IContextNode-Objekte in der IAnalysisWarning-Klassewarning abrufen und nur die Anzahl der IContextNode-Objekte abrufen.

// 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); 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Header	IACom.h (erfordert auch IACom_i.c)
DLL	IACom.dll

Weitere Informationen

IAnalysisWarning

IContextNode

IInkAnalyzer::FindNode-Methode

Freihandanalysereferenz