Metodo IAnalysisWarning::GetNodeIds

Restituisce gli identificatori di tutti i nodi di contesto pertinenti associati a questo avviso.

Sintassi

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

Parametri

pulCount [in, out]

Numero di identificatori univoci globali (GUID) in ppNodeIds.

ppNodeIds [out]

Puntatore a una matrice di GUID che identifica i nodi di contesto associati a questo avviso di analisi o NULL se nessun nodo di contesto è associato all'avviso.

Valore restituito

Per una descrizione dei valori restituiti, vedere Classi e interfacce - Analisi input penna.

Commenti

Se ppNodeIds viene passato come NULL, il metodo GetNodeIds restituisce S_OK e il numero di rettangoli viene restituito in pulCount.

Attenzione

Per evitare una perdita di memoria, usare CoTaskMemFree per rilasciare la memoria da *ppNodeIds quando non sono più necessarie le informazioni.

Esempio

Nell'esempio seguente viene illustrato come ottenere gli oggetti IContextNode presenti nell'oggetto IAnalysisWarning, warninge come ottenere solo il numero di oggetti 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); 

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Intestazione	IACom.h (richiede anche IACom_i.c)
DLL	IACom.dll

Vedi anche

IAnalysisWarning

IContextNode

Metodo IInkAnalyzer::FindNode

Informazioni di riferimento per l'analisi dell'input penna