Metodo IDebugSymbols3::SetScopeFrameByIndex (dbgeng.h)

Articolo
02/23/2024

Il metodo SetScopeFrameByIndex imposta l'ambito corrente sull'ambito di uno dei frame nello stack di chiamate.

Sintassi

HRESULT SetScopeFrameByIndex(
  [in] ULONG Index
);

Parametri

[in] Index

Specifica l'indice dello stack frame da cui impostare l'ambito. L'indice conta il numero di frame dall'inizio dello stack di chiamate. Il frame nella parte superiore dello stack, che rappresenta la chiamata corrente, ha indice zero.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

Quando si verifica un evento e il motore del debugger si interrompe in una destinazione, l'ambito viene impostato sulla chiamata di funzione corrente (la funzione in esecuzione quando si è verificato l'evento). La chiamata a questo metodo con Index impostato su uno modificherà l'ambito corrente al chiamante della funzione corrente; con Index impostato su due, l'ambito viene modificato nel chiamante del chiamante e così via.

Per altre informazioni sugli ambiti, vedere Ambiti e gruppi di simboli.