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 エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| ヘッダー |
|
| [DLL] |
|