Biblioteki DLL (C++/CX)

2023-10-12

Program Visual Studio umożliwia utworzenie standardowej biblioteki DLL Win32 lub biblioteki DLL składnika środowisko wykonawcze systemu Windows, która może być używana przez aplikacje platformy platforma uniwersalna systemu Windows (UWP). Standardowa biblioteka DLL utworzona przy użyciu wersji programu Visual Studio lub kompilatora Microsoft C++ starszego niż program Visual Studio 2012 może nie załadować poprawnie w aplikacji platformy UWP i może nie przejść testu weryfikacyjnego aplikacji w sklepie Microsoft Store.

biblioteki DLL składników środowisko wykonawcze systemu Windows

W prawie wszystkich przypadkach, gdy chcesz utworzyć bibliotekę DLL do użycia w aplikacji platformy UWP, utwórz ją jako składnik środowisko wykonawcze systemu Windows przy użyciu szablonu projektu tej nazwy. Projekt składnika środowisko wykonawcze systemu Windows można utworzyć dla bibliotek DLL, które mają typy środowisko wykonawcze systemu Windows publiczne lub prywatne. Dostęp do składnika środowisko wykonawcze systemu Windows można uzyskać z poziomu aplikacji napisanych w dowolnym języku zgodnym z środowisko wykonawcze systemu Windows. Domyślnie ustawienia kompilatora dla projektu składnika środowisko wykonawcze systemu Windows używają przełącznika /ZW. Plik winmd musi mieć taką samą nazwę, jaką ma główna przestrzeń nazw. Na przykład klasę o nazwie A.B.C.MyClass można utworzyć wystąpienie tylko wtedy, gdy jest ona zdefiniowana w pliku metadanych o nazwie A.winmd lub A.B.winmd lub A.B.winmd lub A.B.C.winmd. Nazwa biblioteki DLL nie jest wymagana do dopasowania nazwy pliku winmd.

Aby uzyskać więcej informacji, zobacz Tworzenie składników środowisko wykonawcze systemu Windows w języku C++.

Aby odwołać się do pliku binarnego składnika środowisko wykonawcze systemu Windows innej firmy w projekcie

Otwórz menu skrótów dla projektu, które będzie używać biblioteki DLL, a następnie wybierz pozycję Właściwości. Na stronie Wspólne właściwości wybierz przycisk Dodaj nowe odwołanie.
Składnik środowisko wykonawcze systemu Windows składa się z pliku DLL i pliku winmd zawierającego metadane. Zazwyczaj te pliki znajdują się w tym samym folderze. W lewym okienku okna dialogowego Dodawanie odwołania wybierz przycisk Przeglądaj , a następnie przejdź do lokalizacji biblioteki DLL i jego pliku winmd. Aby uzyskać więcej informacji, zobacz Rozszerzenia SDK.

Standardowe biblioteki DLL

Możesz utworzyć standardową bibliotekę DLL dla kodu C++, który nie używa ani nie generuje publicznych typów środowisko wykonawcze systemu Windows i używa go z poziomu aplikacji platformy UWP. Użyj typu projektu Dynamic-Link Library (DLL), gdy chcesz przeprowadzić migrację istniejącej biblioteki DLL do skompilowania w tej wersji programu Visual Studio, ale nie przekonwertuj kodu na projekt składnika środowisko wykonawcze systemu Windows. W przypadku wykonywania poniższych kroków biblioteka DLL zostanie wdrożona wraz z plikiem wykonywalnym aplikacji w pakiecie .appx.

Aby utworzyć standardową bibliotekę DLL w programie Visual Studio

Na pasku menu wybierz pozycję Plik, Nowy, Projekt, a następnie wybierz szablon Biblioteka linków dynamicznych (DLL).
Wprowadź nazwę projektu, a następnie wybierz przycisk OK .
Dodaj kod. Pamiętaj, aby użyć __declspec(dllexport) funkcji, które mają zostać wyeksportowane — na przykład __declspec(dllexport) Add(int I, in j);
Dodaj #include winapifamily.h , aby dołączyć ten plik nagłówkowy z zestawu Windows SDK dla aplikacji platformy UWP i ustawić makro WINAPI_FAMILY=WINAPI_PARTITION_APP.

Aby odwołać się do standardowego projektu DLL z tego samego rozwiązania

Otwórz menu skrótów dla projektu, które będzie używać biblioteki DLL, a następnie wybierz pozycję Właściwości. Na stronie Wspólne właściwości wybierz przycisk Dodaj nowe odwołanie.
W okienku po lewej stronie wybierz pozycję Rozwiązanie, a następnie zaznacz odpowiednie pole wyboru w okienku po prawej stronie.
W plikach kodu źródłowego dodaj instrukcję #include dla pliku nagłówka DLL zgodnie z potrzebami.

Aby odwołać się do standardowego pliku binarnego DLL

Skopiuj plik DLL, plik lib i plik nagłówka, a następnie wklej je w znanej lokalizacji — na przykład w bieżącym folderze projektu.
Otwórz menu skrótów dla projektu, które będzie używać biblioteki DLL, a następnie wybierz pozycję Właściwości. Na stronie Właściwości konfiguracji Konsolidator, Dane wejściowe dodaj plik .lib jako zależność.
W plikach kodu źródłowego dodaj instrukcję #include dla pliku nagłówka DLL zgodnie z potrzebami.

Aby przeprowadzić migrację istniejącej biblioteki DLL Win32 na potrzeby zgodności aplikacji platformy UWP

Utwórz projekt typu DLL (uniwersalny system Windows) i dodaj do niego istniejący kod źródłowy.
Dodaj #include winapifamily.h , aby dołączyć ten plik nagłówkowy z zestawu Windows SDK dla aplikacji platformy UWP i ustawić makro WINAPI_FAMILY=WINAPI_PARTITION_APP.
W plikach kodu źródłowego dodaj instrukcję #include dla pliku nagłówka DLL zgodnie z potrzebami.