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