task_continuation_context osztály

Az task_continuation_context osztály lehetővé teszi annak megadását, hogy hol szeretné végrehajtani a folytatást. Ezt az osztályt csak windowsos futtatókörnyezeti alkalmazásból érdemes használni. A nem Windows rendszerű futtatókörnyezeti alkalmazások esetében a feladat folytatásának végrehajtási környezetét a futtatókörnyezet határozza meg, és nem konfigurálható.

Szemantika

class task_continuation_context : public details::_ContextCallback;

Tagok

Nyilvános módszerek

Név	Description
get_current_winrt_context	Egy feladat folytatási kontextus objektumot ad vissza, amely az aktuális winrt szálkörnyezetet jelöli.
használ_tetszőleges	Létrehoz egy tevékenység-folytatási környezetet, amely lehetővé teszi, hogy a futtatókörnyezet válassza ki a folytatás végrehajtási környezetét.
use_current	Egy tevékenység folytatására vonatkozó környezeti objektumot ad vissza, amely az aktuális végrehajtási környezetet jelöli.
use_default	Létrehozza az alapértelmezett tevékenység-folytatási környezetet.
use_synchronous_execution	Egy tevékenység folytatására vonatkozó környezeti objektumot ad vissza, amely a szinkron végrehajtási környezetet jelöli.

Öröklési hierarchia

_ContextCallback

task_continuation_context

Requirements

Fejléc: ppltasks.h

Névtér: egyidejűség

get_current_winrt_context

Egy tevékenység folytatására vonatkozó környezeti objektumot ad vissza, amely az aktuális WinRT-szálkörnyezetet jelöli.

Szemantika

static task_continuation_context get_current_winrt_context();

Visszaadott érték

A Windows futtatókörnyezet aktuális szálkörnyezete. Üres task_continuation_context-et ad vissza, ha nem Windows Runtime környezetből hívják meg.

Megjegyzések

A get_current_winrt_context metódus rögzíti a hívó Windows futtatókörnyezeti szálának környezetét. Üres környezetet ad vissza a nem Windows rendszerű futtatókörnyezet hívóinak.

A visszaadott get_current_winrt_context érték alapján jelezheti a futtatókörnyezetnek, hogy a folytatást a rögzített környezet lakásmodelljében kell végrehajtani (STA és MTA), függetlenül attól, hogy az előzményfeladat lakásfüggő-e. A lakásérzékeny tevékenység olyan tevékenység, amely feloldja a Windows futtatókörnyezet IAsyncInfo felületét, vagy egy ilyen tevékenységből származó feladat.

Ez a módszer hasonló a use_current módszerhez, de natív C++ kódhoz is elérhető C++/CX kiterjesztés támogatása nélkül. A C++/CX-agnostic kódtár kódját natív és Windows futtatókörnyezeti hívókhoz egyaránt író speciális felhasználók számára készült. Ha nincs szüksége erre a funkcióra, javasoljuk a use_current metódust, amely csak a C++/CX ügyfelek számára érhető el.

használat_tetszőleges

Létrehoz egy tevékenység-folytatási környezetet, amely lehetővé teszi, hogy a futtatókörnyezet válassza ki a folytatás végrehajtási környezetét.

Szemantika

static task_continuation_context use_arbitrary();

Visszaadott érték

Egy tetszőleges helyet jelképező tevékenységfolytatási környezet.

Megjegyzések

Ha ezt a folytatási környezetet használja, a folytatás egy olyan környezetben lesz végrehajtva, amelyet a futtatókörnyezet akkor is kiválaszt, ha az előzményfeladat lakástudatos.

use_arbitrary segítségével kikapcsolhatja az sta-ban létrehozott lakásérzékeny feladat folytatásának alapértelmezett viselkedését.

Ez a módszer csak a Windows Runtime-alkalmazások számára érhető el.

aktuális_használat

Egy tevékenység folytatására vonatkozó környezeti objektumot ad vissza, amely az aktuális végrehajtási környezetet jelöli.

static task_continuation_context use_current();

Visszaadott érték

Az aktuális végrehajtási környezet.

Megjegyzések

Ez a metódus rögzíti a hívó Windows futtatókörnyezetét, hogy a folytatások a megfelelő lakásban végrehajthatók legyenek.

A visszaadott use_current érték alapján jelezheti a futtatókörnyezetnek, hogy a folytatásnak a rögzített környezetben (STA vagy MTA) kell futnia, függetlenül attól, hogy az előzményfeladat lakásérzékeny-e. A lakásérzékeny tevékenység olyan tevékenység, amely feloldja a Windows futtatókörnyezet IAsyncInfo felületét, vagy egy ilyen tevékenységből származó feladat.

Ez a módszer csak a Windows Runtime-alkalmazások számára érhető el.

alapértelmezett használata

Létrehozza az alapértelmezett tevékenység-folytatási környezetet.

static task_continuation_context use_default();

Visszaadott érték

Az alapértelmezett folytatási környezet.

Megjegyzések

Az alapértelmezett környezet akkor használatos, ha a metódus meghívásakor nem ad meg folytatási then környezetet. A Windows 7 és újabb windowsos alkalmazásokban, valamint a Windows 8-as és újabb rendszerű asztali alkalmazásokban a futtatókörnyezet határozza meg, hogy hol hajtják végre a tevékenységek folytatását. Windows futtatókörnyezeti alkalmazásokban azonban a folytatás alapértelmezett folytatási környezete egy lakásérzékeny feladat esetében az a lakás, ahol then a rendszer meghívja.

A lakásérzékeny tevékenység olyan tevékenység, amely feloldja a Windows futtatókörnyezet IAsyncInfo felületét, vagy egy ilyen tevékenységből származó feladat. Ezért ha egy Windows Futtatókörnyezeti STA-ban egy lakásérzékeny feladat folytatását ütemezi, a folytatás az adott sta-ban lesz végrehajtva.

A nem apartman-tudatos feladat folytatására a futtatókörnyezet által automatikusan választott környezetben kerül sor.

task_continuation_context::use_synchronous_execution

Egy tevékenység folytatására vonatkozó környezeti objektumot ad vissza, amely a szinkron végrehajtási környezetet jelöli.

Szemantika

static task_continuation_context use_synchronous_execution();

Visszaadott érték

A szinkron végrehajtási környezet.

Megjegyzések

A use_synchronous_execution metódus arra kényszeríti a folytatási tevékenységet, hogy szinkron módon fusson a környezetben, ami az előzménytevékenység befejezését okozza.

Ha az előzményfeladat már befejeződött a folytatás csatolásakor, a folytatás szinkron módon fut a folytatást csatoló környezetben.

Lásd még

egyidejű névtér