Метод IAnalysisWarning::GetNodeIds
Возвращает идентификаторы всех соответствующих узлов контекста, связанных с этим предупреждением.
Синтаксис
HRESULT GetNodeIds(
[in, out] ULONG *pulCount,
[out] GUID **ppNodeIds
);
Параметры
-
pulCount [вход, выход]
-
Количество глобальных уникальных идентификаторов (GUID) в ppNodeIds.
-
ppNodeIds [out]
-
Указатель на массив идентификаторов GUID, который идентифицирует узлы контекста, связанные с этим предупреждением анализа, или значение NULL , если с предупреждением не связаны узлы контекста.
Возвращаемое значение
Описание возвращаемых значений см. в разделе Классы и интерфейсы — анализ рукописного ввода.
Комментарии
Если ppNodeIds передается как NULL, метод GetNodeIds возвращает S_OK и число прямоугольников возвращается в pulCount.
Внимание!
Чтобы избежать утечки памяти, используйте CoTaskMemFree, чтобы освободить память от *ppNodeIds , когда информация больше не нужна.
Примеры
В следующем примере показано, как получить объекты IContextNode , которые находятся в IAnalysisWarning, warningи как получить только количество объектов 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);
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP Tablet PC Edition [только классические приложения] |
| Минимальная версия сервера |
Ни одна версия не поддерживается |
| Заголовок |
|
| DLL |
|