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 |
|
| DLL |
|