Makale numaras�: 132044 - Son G�zden Ge�irme: 02 Aral�k 2003 Sal� - G�zden ge�irme: 2.0

BILGI: _declspec(dllimport) & _declspec(dllexport) kod i�inde kullanma

�ngilizce ve T�rk�e'yi yan yana g�r�nt�leme

Buraya t�klayarak �ngilizce ve T�rk�e'yi yan yana g�r�nt�leyebilirsiniz.

Otomatik terc�me makalelerin ne oldu�unu a��klayan yaz�y� okumak i�in buraya t�klay�n

Kullan�m D�� Bilgi Bankas� ��eri�i Yasal Uyar�

Bu makalenin ge�erli oldu�u �r�nleri g�r�n.

Sistem �pucuBu makale, kulland��n�zdan farkl� bir i�letim sistemine y�neliktir. Sizinle ilgili olmayabilecek makale i�eri�i devre d�� b�rak�ld�.

�zet

Bu makalede, Microsoft Bilgi Bankas�'ndaki a�a��daki makalede anlat�lan bilgiler tamamlar:

107501� (http://support.microsoft.com/kb/107501/EN-US/ ) BILGI: __declspec, Visual C++ 32-bit olarak de�i�tirilen __export

Bu makalede, olumlu ve _declspec(dllimport) ve _declspec(dllexport) uygulaman�zda kullanman�n mechanics anlat�l�r.

�ste

Visual C++'�n 32-bit s�r�m� _declspec(dllimport) _declspec(dllexport) �nceden Visual C++ 16-bit s�r�mlerinde kullan�lan __export anahtar s�zc�� de�i�tirmek i�in kullan�r.

Do�ru derlemeye _declspec(dllimport) kodunuz i�in kullanmak gerekmez, ancak yapmak, b�ylece daha iyi kod �retmede derleyici sa�lar. Derleyici, emin olmak i�in bir i�lev veya bir DLL dosyas�nda bulunup bildi�inden, daha iyi kod olu�turmak, derleyici zamanki y�nlendirme d�zeyi Atla kodlar�n� olu�turabilir, b�ylece bir i�lev �a�r�s�nda bir DLL s�n�r� a��ld� bulunmas� m�mk�n olur.

Uygun .def dosyas� EXPORTS b�l�mle, _declspec(dllexport) gerekli de�ildir. _declspec(dllexport), bir .def dosyas� kullanmadan bir .exe veya .dll i�levleri vermek i�in kolay bir yol sa�lamak i�in eklenmi�tir.

Bu makalenin geri kalan�nda, bu sorunlar�n olduk�a d��k d�zeyli, kapsaml� bir tart��ma sa�lar.

Win32 ta��nabilir y�r�t�lebilir dosyas� bi�imini al�r D�zeltilecek i�lemdeki gereken sayfalar�n say�s�n� en aza indirmek i�in tasarlanm��t�r. Bunu yapmak i�in <a0></a0>, herhangi bir program� i�in t�m alma adresleri Al adres tablosu olarak adland�r�lan tek bir yerde yerle�tirir. Bu, y�kleyici, yaln�zca bir veya iki sayfa bu al�r eri�irken de�i�tirmeye olanak sa�lar.

�ste

I�lev �a�r�lar� i�in _declspec(DllImport) kullanma

A�a��daki kod �rne�i, func1 main() i�levini i�eren .exe dosyas�ndan ayr� bir DLL bulunan bir i�levdir varsayal�m.

Bu kod _declspec(DllImport), verilen:

void main(void) {
    func1();
}

�una benzer bir kod derleyici olu�turur:

call func1

ve ��yle bir �ey �a�r�da linker �evirir:

call 0x4000000         ; The address of 'func1'.

ba�ka bir DLL dosyas�nda 'func1' var, 'func1' nin adresini nedir bilmenin bir yolu yoktur ��nk� linker bunu do�rudan ��zmek ba�latam�yor. 16-Bit ortamlarda, the linker bir listede, y�kleyiciyi �al��ma zaman�nda do�ru adresle d�zeltme eki .exe bu kod adresi ekler. 32 Bit ortamlarda, kendisi i�in bu adresi biliyor bir thunk the linker olu�turur. The thunk ��yle g�r�n�r:

   0x40000000:    jmp DWORD PTR __imp_func1

burada __imp_func1 .exe dosyas�n�n <a1>alma</a1> adresi tablosundaki func1'�n yuvay� adresidir. T�m adresleri b�ylece i�in linker olarak bilinir. Y�kleyiciyi yaln�zca .exe dosya alma adresi tablosu, her �ey d�zg�n �al��mas� i�in y�kleme zaman�nda g�ncelle�tirmek de vard�r.

The linker bir thunk olu�turmuyor i�in yoksa, daha iyi oldu�u i�in bu nedenle _declspec(dllimport) kullanarak daha uygundur. Kod thunks b�y�tmek (r�sc TABANL� sistemlerde, onu birka� y�nergeleri olabilir) ve kendi �nbellek performans d��ebilir. Derleyici bir DLL'dir bir i�lev bildirmek, onu dolayl� bir �a�r� sizin i�in olu�turabilir.

B�ylece art�k bu kod:

__declspec(dllimport) void func1(void);

void main(void) {
    func1();
}

bu y�nergesi olu�turur:

call DWORD PTR __imp_func1

yok yok thunk ve hi�bir jmp y�nerge; bu nedenle, daha k��k ve h�zl� kodudur.

�te yandan, bir DLL i�inde i�lev �a�r�lar� i�in dolayl� bir �a�r� kullanmak zorunda istemiyorum. Bir i�levin adresi zaten biliyor. Zaman ve yer y�klemek ve do�rudan bir aramay� her zaman daha h�zl� ve daha k��k olacak �ekilde dolayl� bir �a�r� �nce i�levin adresi depolamak i�in gereklidir. Yaln�zca __declspec(dllimport) DLL i�levleri d��ndaki ararken kullanmak istedi�iniz DLL kendisi. __Declspec(DllImport) i�inde bir DLL i�levi, bu DLL olu�tururken kullanmay�n.

�ste

_Declspec(dllexport) kullanma

Microsoft, derleyici verme adlar� otomatik olarak olu�turmak ve bunlar� bir .LIB dosyas�nda izin vermek i�in 16 bit Derleyicisi s�r�m __export kullan�ma sunmu�tur. Bir DLL ile ba�lamak i�in bu .LIB dosya sonra yaln�zca statik bir .LIB gibi kullan�labilir.

Microsoft, bu kullan��l� devam etmek i�in __declspec(dllexport) eklendi. Amac�; bu nedenle, bir .def dosyas� gerekmeyen nesne dosyaya verme y�nergesini eklemektir.

Vermek istedi�iniz, C++ i�lev adlar� donat�lm�� bu kullan��l� en belirgin olur. Verilen bir fonksiyonun ad�n�, derleyici s�r�mleri aras�nda de�i�ebilir, dolay�s�yla ad d�zenleme i�in standart belirtim yoktur. _Declspec(dllexport) kullan�rsan�z, DLL ve ba��ml� .exe dosyalar� recompiling adland�rma kural�na de�i�iklikleri yaln�zca hesap i�in gereklidir.

S�ra say�lar�n�, NONAME veya PRIVATE, bir .def dosyas� yaln�zca yap�labilir ve bir .def dosyas� olmadan bu �znitelikleri belirtmek i�in bir yol gibi bir�ok y�nergeleri verin. Ancak, bir .def dosyas� kullanarak ek olarak _declspec(dllexport) kullanarak derleme hatalar� neden olmaz.

Ba�vuru olarak Win32 WINBASE.H �stbilgi dosyas� arac�l��yla aray�n. Bu, tercih edilen __declspec(dllexport) ve __declspec(dllimport) kullan�m �rnekleri i�erir.

�ste

_Declspec(dllexport) _declspec(dllimport) �zerinde veri ile

S�z konusu oldu�unda, _declspec(dllimport) kullanarak bir y�nlendirme katman� silen bir kullan��l� maddenin veridir. Bir DLL dosyas�ndan veri ald��n�zda, hala alma adresi tablosu gitmek zorunda. Win32 g�n _declspec(dllimport) �nce <a0></a0> Bu verilere, DLL dosyas�ndan verilen zaman fazladan bir y�nlendirme d�zeyi yapmak, an�msamak zorunda kald� yap�s�ndaki:

// project.h
#ifdef _DLL     // If accessing the data from inside the DLL
   ULONG ulDataInDll;

else            // If accessing the data from outside the DLL
   ULONG *ulDataInDll;
#endif

, ard�ndan verileri .def dosyan�za vermek:

// project.def
LIBRARY project
EXPORTS
    ulDataInDll   CONSTANT

ve DLL d��nda eri�im:

if (*ulDataInDll == 0L) {
   // Do stuff here
}

verileri __declspec(dllimport) olarak i�aretlemek, derleyici otomatik olarak y�nlendirme kod sizin i�in olu�turur. Art�k yukar�daki ad�mlar� hakk�nda endi�elenmeniz gerekmez. Yukar�da belirtildi�i gibi DLL olu�tururken _declspec(dllimport) bildirimi veri kullanmay�n. DLL i�levlerinde adres tablosu alma, veri nesnesine eri�meye kullanmayacakt�r. Bu nedenle, ek y�nlendirme mevcut d�zeyini olmayacak.

Verileri otomatik olarak bir DLL dosyas�ndan vermek i�in <a0></a0>, bu bildirimi kullan�n:

__declspec(dllexport) ULONG ulDataInDLL;

�ste

Bir .def dosyas� kullanma

__Declspec(dllimport) bir .def dosyas� ile birlikte kullanmay� se�erseniz, yanl�� kodlama sorun olu�turaca��n� olas�l��n� azaltmak i�in SABIT yerine VERI kullanmak i�in .def dosyas� de�i�tirmelisiniz:

// project.def
LIBRARY project
EXPORTS
    ulDataInDll   DATA

a�a��daki grafik neden g�sterir:

Keyword     Emits in the import lib     Exports
CONSTANT    __imp_ulDataInDll           ulDataInDll
            __ulDataInDll

DATA        __imp_ulDataInDll           ulDataInDll

_declspec (dllimport) ve SABIT kullanma __imp_ s�r�m� hem de a��k ba�lama izin vermek i�in olu�turulan .LIB DLL alma kitapl��ndaki undecorated ad�n� listeler. _Declspec(DllImport) ve VERI kullanarak, yaln�zca ad __imp_ s�r�m�n� listeler.

SABITINI kullan�rsan�z, a�a��daki kod yap?lar?n? birini ulDataInDll eri�mek i�in kullan�labilir:

__declspec(dllimport) ULONG ulDataInDll; /*prototype*/ 
   if (ulDataInDll == 0L)   /*sample code fragment*/

-VEYA-

ULONG *ulDataInDll;      /*prototype*/ 
if (*ulDataInDll == 0L)  /*sample code fragment*/

VERI .def dosyan�zda kullan�rsan�z, yaln�zca a�a��daki tan�m�yla derlenmi� kod de�i�ken ulDataInDll ancak eri�ebilirsiniz:

__declspec(dllimport) ULONG ulDataInDll;
if (ulDataInDll == 0L)   /*sample code fragment*/

ek y�nlendirme d�zeyini kullanmak unutursan�z, olas� alma adresi tablonun i�aret�i de�i�keni--de�i�ken kendisini eri�ebilecek kullanarak CONSTANT daha tehlikelidir ��nk�. Bu t�r bir adres tablosu alma linkers ve Microsoft derleyici taraf�ndan salt okunur yap�lan ge�erli i�in eri�im ihlali genellikle listesi.

Bu durumda bu hesap i�in .def dosyas� i�inde SABIT g�r�r, ge�erli Visual C++ linker bir uyar� verir. Yaln�zca ger�ek nedeni SABITINI kullan�rsan�z, burada �stbilgi dosyas� �zerinde prototip dllimport liste belgemde baz� nesne dosyas�n� yeniden ba�latam�yor, olur.

�ste

Referanslar

Visual C++ Books Online'da sa�layan �nemli miktarda bir belge dllexport ve dllimport depolama s�n�f� �znitelikleri. Bu, programlama teknikleri ba�vuru "DLL Win32 i�in olu�turma" b�l�mde "Dllexport ve dllimport �znitelikleri" ve C++ Dil Ba�vurusu, "Microsoft �zg� de�i�tiriciler" b�l�m "Using dllimport ve C++ i�inde dllexport" konular�nda "Simgeleri verme" konular� i�erir. Kapsaml� bir listesi i�in ilgili konular Books Online'da "dllimport" veya "dllexport" i�in arama yap�n.

Daha fazla bilgi i�in, a�a��daki Microsoft Knowledge Base makalelerine bak�n:

90530� (http://support.microsoft.com/kb/90530/EN-US/ ) Nas�l yap�l�r: bir DLL DOSYAS� veya uygulama veri ver

107501� (http://support.microsoft.com/kb/107501/EN-US/ ) BILGI: __declspec, Visual C++ 32-bit olarak de�i�tirilen __export

�ste

Bu makaledeki bilginin uyguland�� durum:

Microsoft Visual C++ 1.0 Professional Edition
Microsoft Visual C++ 2.0 Professional Edition
Microsoft Visual C++ 2.1
Microsoft Visual C++ 4.0 Standard Edition
Microsoft Visual C++ 5.0 Enterprise Edition
Microsoft Visual C++ 5.0 Professional Edition

�ste

kbmt kbcode kbcompiler kbinfo KB132044 KbMttr

�ste

Otomatik Terc�me

�NEML�: Bu makale, bir ki�i taraf�ndan �evrilmek yerine, Microsoft makine-�evirisi yaz�l�m� ile �evrilmi�tir. Microsoft size hem ki�iler taraf�ndan �evrilmi�, hem de makine-�evrisi ile �evrilmi� makaleler sunar. B�ylelikle, bilgi bankam�zdaki t�m makalelere, kendi dilinizde ula�m�� olursunuz. Bununla birlikte, makine taraf�ndan �evrilmi� makaleler m�kemmel de�ildir. Bir yabanc�n�n sizin dilinizde konu�urken yapabilece�i hatalar gibi, makale; kelime da�arc��, s�z dizim kurallar� veya dil bilgisi a��s�ndan yanl��lar i�erebilir. Microsoft, i�eri�in yanl�� evrimi veya onun m��teri taraf�ndan kullan�m�ndan do�an; kusur, hata veya zarardan sorumlu de�ildir. Microsoft ayr�ca makine �evirisi yaz�l�m�n� s�k�a g�ncellemektedir.

Makalenin �ngilizcesi a�a��daki gibidir:132044� (http://support.microsoft.com/kb/132044/en-us/ )

�ste

Kullan�m D�� Bilgi Bankas� ��eri�i Yasal Uyar�

Bu makale, Microsoft'un art�k destek sa�lamad�� r�nler ile ilgili olarak yaz�lm��t�r. Bu nedenle, bu makale "oldu�u gibi" sa�lanm��t�r ve bundan sonra g�ncelle�tirilmeyecektir.

�ste

This site in other countries/regions:

BILGI: _declspec(dllimport) & _declspec(dllexport) kod i�inde kullanma

Bu Sayfada

�zet

Daha fazla bilgi

I�lev �a�r�lar� i�in _declspec(DllImport) kullanma

_Declspec(dllexport) kullanma

_Declspec(dllexport) _declspec(dllimport) �zerinde veri ile

Bir .def dosyas� kullanma

Referanslar

Bu makaledeki bilginin uyguland�� durum:

Anahtar Kelimeler:�

Di�er Destek Siteleri

Topluluk

Makale �evirileri

This site in other countries/regions:

BILGI: _declspec(dllimport) & _declspec(dllexport) kod i�inde kullanma

Bu Sayfada

�zet

Daha fazla bilgi

I�lev �a�r�lar� i�in _declspec(DllImport) kullanma

_Declspec(dllexport) kullanma

_Declspec(dllexport) _declspec(dllimport) �zerinde veri ile

Bir .def dosyas� kullanma

Referanslar

Bu makaledeki bilginin uyguland��� durum:

Anahtar Kelimeler:�

Di�er Destek Siteleri

Topluluk

Makale �evirileri

Bu makaledeki bilginin uyguland�� durum: