IAnalysisWarning::GetNodeIds メソッド

  • [アーティクル]

この警告に関連付けられている関連するコンテキスト ノードの識別子を返します。

構文

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

パラメーター

pulCount [in, out]

ppNodeIds 内のグローバル一意識別子 (GUID) の数。

ppNodeIds [out]

この分析警告に関連付けられているコンテキスト ノードを識別する GUID の配列へのポインター。警告に関連付けられているコンテキスト ノードがない場合は NULL 。

戻り値

戻り値の説明については、「 クラスとインターフェイス - インク分析」を参照してください。

解説

ppNodeIds が NULL として渡された場合、GetNodeIds メソッドは S_OKを返し、四角形の数は pulCount で返されます。

注意事項

メモリ リークを回避するには、 CoTaskMemFree を使用して、情報が不要になったときに *ppNodeIds からメモリを解放します。

例

次の例は、IAnalysisWarning 内の IContextNode オブジェクトを取得する方法と、warningIContextNode オブジェクトの数のみを取得する方法を示しています。

// 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 タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
ヘッダー
IACom.h (IACom_i.c も必要)
[DLL]
IACom.dll

関連項目

IAnalysisWarning

IContextNode

IInkAnalyzer::FindNode メソッド

インク分析リファレンス