IDebugHostContextExtensibility::CloneContextForModification-Methode (dbgmodel.h)

Diese Methode klont den aktuellen Hostkontext und gibt eine einmalige Änderungsschnittstelle zurück, um Daten dem Kontext zuzuordnen.

Syntax

HRESULT CloneContextForModification(
  IDebugHostContextExtension **extensionHandle
);

Parameter

extensionHandle

Dieser Parameter verweist auf einen IDebugHostContextExtension-Zeiger, der zum Abrufen der Hostkontexterweiterung verwendet wird. Dies ist ein Ausgabeparameter für den geklonten Kontext.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Die CloneContextForModification-Methode wird verwendet, um den aktuellen Hostkontext für eine einmalige Änderung und eventuelle Unveränderlichkeit zu klonen. Es ist erforderlich, die FinalizeContext-Methode aufzurufen, um den geklonten Kontext abzuschließen und zum tatsächlich geklonten Kontext zurückzukehren. Danach wird der zurückgegebene Hostkontext unveränderlich und kann nicht weiter geändert werden.

Anforderungen

Siehe auch

IDebugHostContextExtensibility-Schnittstelle