Biblioteka szablonów języka C++ środowiska wykonawczego systemu Windows (WRL)

Biblioteka szablonów C++ środowiska wykonawczego systemu Windows (WRL) Jest biblioteka szablon, który umożliwia niskiego poziomu autor i używać Środowisko wykonawcze systemu Windows składników.

Korzyści

WRL Można łatwo zaimplementować i zużyje składniki Component Object Model (COM).Zapewnia technik sprzątania, jak zliczanie odwołań zarządzać okresem istnienia obiektów i badania HRESULT wartości w celu określenia, czy operacja pomyślnych lub niepomyślnych.Udane korzystanie z WRL, musi dokładnie się te reguły i techniki.

Rozszerzenia składników dla programu Visual C++ (C++/CX) Jest wysokiego szczebla, oparte na języku sposobem użycia Środowisko wykonawcze systemu Windows składników.Obie WRL i C++/CX upraszczającym pisanie kodu dla Środowisko wykonawcze systemu Windows przez automatyczne wykonywanie zadań sprzątanie w Twoim imieniu.

WRL i C++/CX różne świadczenia.Oto kilka powodów, należy użyć WRL zamiast C++/CX:

• WRLDodaje mały abstrakcji ponad Środowisko wykonawcze systemu Windows aplikacji binarne interfejsu (ABI), daje możliwość kontrolowania podstawowych kod, aby lepiej utworzenia lub wykorzystania Środowisko wykonawcze systemu Windows interfejsów API.

• C++/CXreprezentuje COM HRESULT wartości jako wyjątki.Jeśli już dziedziczone bazy kodów korzystającej z modelu COM lub jeden nie używającej wyjątki, może być stwierdzisz, że WRL jest bardziej naturalne sposobem pracy z Środowisko wykonawcze systemu Windows ponieważ nie trzeba używać wyjątków.

  [!UWAGA]

  WRL Korzysta z HRESULT wartości, a nie generują wyjątki.Dodatkowo WRL zastosowań inteligentne wskaźniki i wzór RAII w celu zagwarantowania, że obiekty są poprawnie niszczone, gdy zgłasza wyjątek, kod aplikacji.Aby uzyskać więcej informacji o Sprytne wskaźniki i RAII, zobacz Inteligentne kursory (Podręcznik programowania C++ nowoczesny) i Zasoby własne obiekty (RAII).

• Cel i projekt WRL jest INSPIROWANE przez Active Template Library (ATL), który jest to zbiór klas C++ opartych na szablonie, które uproszczenia programowania obiektów COM.Ponieważ WRL używa standardu C++ oblewania Środowisko wykonawcze systemu Windows, można łatwiej port i interakcji z wielu istniejących składników COM napisanych w ATL do Środowisko wykonawcze systemu Windows.Jeśli znasz już ATL, może być stwierdzisz, że WRL Programowanie jest łatwiejsze.

Rozpoczynanie pracy

Oto kilka zasobów, które pomogą Ci się praca z WRL od razu.

• Biblioteka wykonawcza systemu Windows (WRL)
  W tym wideo kanału 9, Dowiedz się więcej o jak WRL ułatwia pisanie Windows Store aplikacji i jak autor i zużywają Środowisko wykonawcze systemu Windows składników.

• Porady: uaktywnianie składnika środowiska wykonawczego systemu Windows za pomocą biblioteki WRL i korzystanie z niego
  Przedstawiono sposób użycia WRL zainicjować Środowisko wykonawcze systemu Windows i uaktywnić i używać Środowisko wykonawcze systemu Windows składnika.

• Porady: wykonywanie operacji asynchronicznych z użyciem biblioteki WRL
  Przedstawiono sposób użycia WRL do uruchamiania operacji asynchronicznych i wykonywania pracy, po ukończeniu operacji.

• Porady: obsługa zdarzeń z użyciem biblioteki WRL
  Przedstawiono sposób użycia WRL subskrybować i obsługi zdarzeń z Środowisko wykonawcze systemu Windows obiektu.

• Wskazówki: tworzenie podstawowego składnika środowiska wykonawczego systemu Windows za pomocą biblioteki WRL
  Przedstawiono sposób użycia WRL do utworzenia podstawowego Środowisko wykonawcze systemu Windows składnika, która dodaje dwie liczby.Ilustruje też sposób wywołania zdarzeń i korzystanie ze składnika z Windows Store aplikacja, która wykorzystuje JavaScript.

• Wskazówki: tworzenie aplikacji sklepu Windows Store z użyciem biblioteki WRL i platformy Media Foundation
  Informacje o sposobie tworzenia Windows Store aplikacja, która używa Microsoft Media Foundation.

• Porady: tworzenie klasycznego składnika COM za pomocą biblioteki WRL
  Przedstawiono sposób użycia WRL do utworzenia podstawowego składnika modelu COM i najprostszy sposób zarejestrować i zużywają składnika modelu COM z aplikacji pulpitu.

• Porady: bezpośrednie tworzenie wystąpień składników biblioteki WRL
  Informacje o sposobach używania Microsoft::WRL::Make i Microsoft::WRL::Details::MakeAndInitialize funkcje tworzenia wystąpienia składnika z modułu, który definiuje go.

• Przewodnik: Łączenie, za pomocą zadań i żądania HTTP XML (IXHR2)
  Przedstawiono sposób użycia IXMLHTTPRequest2 i IXMLHTTPRequest2Callback interfejsy, łącznie z zadania, aby wysyłać żądania HTTP GET i POST do usługi sieci web, w Windows Store aplikacji.

• Przykładowe Bing Maps podróży służbowej Optymalizator
  Używa HttpRequest klasy, która jest zdefiniowana w Przewodnik: Łączenie, za pomocą zadań i żądania HTTP XML (IXHR2) w kontekście pełnego Windows Store aplikacji.

• Hybrydowe app DLL serwera autorstwa próbki
  Pokazuje sposób użycia WRL deklarować i implementować interfejsów i pracować z właściwości, metod i zdarzeń.

• Przykładowe gier DirectX Labirynt Marmur-
  Pokazuje sposób użycia WRL zarządzać okresem istnienia składników COM, takie jak DirectX i platformy Media Foundation w kontekście pełne gry 3-w.

• Wysyłanie powiadomień toast z próbki aplikacji
  Pokazuje sposób użycia WRL do pracy z powiadomień toast z aplikacji pulpitu.

WRLW porównaniu do biblioteki ATL

WRLpodobny do Active Template Library (ATL), ponieważ służy do tworzenia małych, szybko obiektów COM.WRLi ATL również udział pojęć, takich jak definicji obiektów w modułach, jawne rejestracji interfejsów i otworzyć Tworzenie obiektów przy użyciu fabryk.Może być wygodne z WRL użytkownicy zaznajomieni z ATL

WRLobsługuje funkcje COM, który jest wymagany dla Windows Store aplikacji.W związku z tym różni się od ATL ponieważ pominięto bezpośrednie wsparcie dla funkcji COM takich jak:

• Agregacja

• implementacje akcji

• liczbą interfejsów (IDispatch)

• Standardowy moduł wyliczający interfejsów

• punkty połączeń

• interfejsy do odrywania

• Osadzanie OLE

• Formanty ActiveX

• COM +

Pojęcia

WRLdostępne typy, które reprezentują kilka podstawowych pojęć.W poniższych sekcjach opisano te typy.

ComPtr

ComPtr jest inteligentnego wskaźnika typu, który reprezentuje interfejs, który jest określony przez parametr szablonu.Użycie ComPtr Aby zadeklarować zmienną, którego mają dostęp członkowie obiekt, który pochodzi z interfejsu.ComPtrautomatycznie przechowuje licznika odwołań do podstawowej wskaźnika interfejsu i zwalnia interfejsu po licznika odwołań jest zerowa.

RuntimeClass

RuntimeClass reprezentuje wystąpień klasy, która dziedziczy zbiór interfejsów określonego.A RuntimeClass obiekt może dostarczyć będącej połączeniem obsługi dla jednego lub więcej Środowisko wykonawcze systemu Windows interfejsów COM lub słabe odwołanie do składnika.

Moduł

Moduł stanowi zbiór powiązanych obiektów.A Module zarządza obiekt fabryk klas, które tworzą obiekty i rejestracji, które umożliwia innym aplikacjom korzystanie z obiektu.

Wywołanie zwrotne

Wywołania zwrotnego funkcja tworzy obiekt, którego funkcją składową jest program obsługi zdarzeń (Metoda wywołania zwrotnego).Użycie Callback funkcja pisać operacji asynchronicznych.

Źródła zdarzeń

Źródła zdarzeń jest używana do zarządzania delegować programy obsługi zdarzeń.Użyj WRL wdrożenia pełnomocnik i użyć EventSource Aby dodać, usunąć i wywoływać delegatów.

AsyncBase

AsyncBase dostarcza metod wirtualnych, które reprezentują Środowisko wykonawcze systemu Windows asynchronicznego model programowania.Zastąpić elementy członkowskie należące do tej klasy do utworzenia niestandardowej klasy, które można uruchomić, zatrzymać lub sprawdzić postęp operację asynchroniczną.

FtmBase

FtmBase reprezentuje obiekt bezwątkowego przegrupowywania danych.FtmBaseutworzenie tabeli interfejsu globalnego (GIT) i pomaga zarządzać obiektami kierowanie i serwera proxy.

WeakRef

WeakRef jest typu inteligentnej wskaźnik, który reprezentuje Odwołanie tymczasowe, która odwołuje się do obiektu, który może lub nie mogą być niedostępne.A WeakRef obiektu można za pomocą tylko Środowisko wykonawcze systemu Windows, a nie przez klasyczny model COM.

A WeakRef obiektu zazwyczaj reprezentuje obiekt, którego istnienie jest kontrolowana przez gwint zewnętrzny lub aplikacji.Na przykład WeakRef obiektu można odwołać się za obiekt pliku.Gdy plik jest otwarty, WeakRef jest prawidłowa i pliku odwołania jest dostępny.Ale, gdy plik zostanie zamknięty, WeakRef jest nieprawidłowy i plik nie jest dostępny.

Tematy pokrewne

Szablon projektu biblioteki klas WRL	Informacje dotyczące dostępu do szablonu projektu biblioteki klas w światowym laboratorium Referencyjnym.Ten szablon pomaga uprościć zadanie przy użyciu programu Visual Studio do utworzenia Środowisko wykonawcze systemu Windows składników.
Kluczowe interfejsy API biblioteki WRL według kategorii	Podświetla podstawowego WRL typów, funkcje i makra.
Odwołanie do biblioteki WRL	Zawiera informacje odwołania do WRL.
Podręczny wykaz (obsługi Windows i języka Visual C++)	W tym artykule krótko opisano C++/CX funkcje obsługujące Środowisko wykonawcze systemu Windows.
Za pomocą składników systemu Windows w czasie wykonywania w programie Visual C++	Przedstawiono sposób użycia C++/CX do utworzenia podstawowego Środowisko wykonawcze systemu Windows składnika.