Makale numaras�: 163449 - Son G�zden Ge�irme: 21 �ubat 2007 �ar�amba - G�zden ge�irme: 4.2

Bir geni�letilmi� sakl� yordam� i� par�ac�� yerel depolama kullan�mda

�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

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�.

I� par�ac�� yerel depolama (TLS), �ok hassas bir konu olabilir. Ortam havuzu i� par�ac�� i�inde �al��rken, TLS ve i� par�ac�� etkile�imleri sonu�lar� anlamak �ok �nemlidir.

Microsoft SQL Server gibi bir ortam havuzu bir i� par�ac��nda TLS �nlemek �nerilir. Ancak, TLS kullanman�z gerekiyorsa, l�tfen dikkatle bu belgeyi okuyun ve TLS ve DLL ana i�levler i�in Win32 SDK's�ndaki �evrimi�i belgelere bak�n.

Ayr�ca, geni�letilmi� sakl� yordamda derleyici y�nergesini __declspec(thread) desteklenmiyor. LoadLibarary ger�ekle�ti�inde __declspec(thread) tan�m d�zg�n ba�lat�lamad�. Daha fazla bilgi i�in bkz: Jeffrey Ricter taraf�ndan "Windows Geli�mi�".

Not: SQL Server'a geni�letilmi� sakl� yordamlar da dahil olmak �zere, herhangi bir uzant�s� hi�bir zaman DisableThreadLibraryCalls() �a�r� yapabilir.

�ste

Daha fazla bilgi

Belirtildi�i gibi i�lev �a�r�lar�n� TlsSetValue ve TlsGetValue kullan�lan dizin de�eri TlsAlloc i�levini verir. Belgelere DLLMain i�levinizin TlsAlloc i�lev �a�r�s� �nerir, ul_reason_for_call DLL_PROCESS_ATTACH =. Varsay�lan olarak, ba�lang��ta y�klenen DLL'NIN DLL_PROCESS_ATTACH denir.

DLL_PROCESS_ATTACH ve DLL_THREAD_ATTACH, bellek ve TlsSetValue aray�n. Bu, �zellikle i� par�ac�� havuzu senaryosunda baz� sorunlara neden ba�lad�� olur.

A�a��da, havuzu i� par�ac�� herhangi bir uygulama i�in ge�erli bir �rnek senaryodur. Bu �rnek Microsoft SQL sunucu uygulamas�n� kullan�r.

Birka� temellerini ��renmeniz gerekir, �rne�in �unlard�r: Bu t�m alt�nda DLLMain i�levi Win32 SDK belgelerinde ayr�nt�l� olarak belgelenmektedir.

Bir DLL y�klendi�inde, DLL_PROCESS_ATTACH �a��r�r.
(DLL y�klendikten sonra k�kenli) t�m sonraki i� par�ac�� DLL_THREAD_ATTACH aray�n.
�u anda �al��an i� par�ac�� (DLL y�klenmeden �nce k�kenli) DLL_THREAD_ATTACH �a��rmay�n.
T�m i� par�ac�klar�, bile, bunlar�n hi�bir zaman DLL_THREAD_ATTACH adl� DLL_THREAD_DETACH, aray�n.

�rne�in, a�a��daki grafik sipari� ve SQL Server'�n i��i i� par�ac�� havuzu kullan�m�n� g�sterir varsayal�m:

   Thread     ATTACH CALLED     COMMAND     USER
------------------------------------------------ 
     1              NO           select      Joe
     2             YES          xp_test     Mary
     3             YES           select     Adam

     1              NO          xp_test     Lynn

Can, uzun s�ren bir se�me deyimini ba�lat�r. Bu nedenle yolu olarak DLL_ATTACH i�leminin hi� kimsenin geni�letilmi� sakl� yordam� hen�z xp_test kulland�.

Gamze, Can'�n se�in �al��rken xp_test �al��r. Mekanizmas� havuzu i� par�ac��, yeni bir i� par�ac�� iste�ine hizmet Can'�n k�kenli belirler. SQL Server, daha sonra Xproc.dll dosyas�n� y�klemek i�in LoadLibrary i�levini �a��r�r. B�ylece, DLL_PROCESS_ATTACH olarak adland�r�l�r; bu nedenle, dll DOSYAS�N�N eklemek i�in ilk i� par�ac��n�n i� par�ac�� 2 olur. Daha �nce anlat�ld�� gibi TlsAlloc geni�letilmi� sakl� yordam�n TLS dizin de�eri'ni ba�latmak i�in �a�r�labilir.

Gamze, Can'�n ve Can'�n komutlar�n� �al��t�r�rken, kendi se�me g�nderir. Yeniden Gamze'n�n bir iste�i i�lemek i�in yeni bir i� par�ac�� k�kenli. LoadLibrary yer ald�� sonra i� par�ac�� 3 k�kenli oldu�undan, i� par�ac��n�n 3 DLL_THREAD_ATTACH �a��r�r. Belirtildi�i gibi 3 i� par�ac�� i�in bellek ayr�lamad� ve TlsSetValue call budur.

Can'�n se�in tamamland��n� varsayal�m, �imdi, b�ylece i��i i� par�ac�� 1 kullan�m� i�in �cretsizdir. Lynn xp_test komutu g�nderir ve i� par�ac�� 1 atan�r. �nceden 1 numaral� olan i� par�ac��, hi�bir zaman DLL_PROCESS_ATTACH veya DLL_THREAD_ATTACH �a��r�r, i� par�ac��n�n �nce k�kenli ��nk� LoadLibrary �a�r�ld�.

Bu �rnekte, TlsGetValue ile TLS belle�e eri�me giri�imleri 1 i� par�ac�� taraf�ndan bir NULL i�aret�isiyle verilen sonu�lar g�rebilirsiniz. Bu ko�ulu denetlemek i�in geni�letilmi� sakl� yordam�n d�zg�n yaz�lmaz, NULL adresine yazmaya �al��t��n�zda eri�im ihlali olu�uyor (AV) kar��la��rs�n�z.

A�a��da belirtilen i� par�ac�� havuzu ve TLS hakk�nda gereken birka� nokta �unlard�r.

TLS havuz bir ortamda kullan�yorsan�z, her zaman NULL bir d�n�� de�eri i�in TlsGetValue denetlemeniz gerekir. NULL geldi�inizde, bellek ve �a�r� LoadLibrary yer ald�� i�in �nce k�kenli burada ak�t�r TlsSetValue olanlar i�lemek i�in do�ru tahsis gerekir.

Ba�ka bir uyar� do�rudan belgelerinde a��klanan bile, i� par�ac��n�n DLL dosyas�nda hi�bir zaman i�levlerini kullan�r, DLLMain i�levi TLS bellekte sonra LoadLibarary, k�kenli her i� par�ac�� i�in tahsis, ' dir. Yukar�daki �rnekte, bu i� par�ac��yla 3 g�sterir. Yaln�zca bir se�in �al��t�, ancak, geni�letilmi� sakl� yordam� i�in TLS bellek tahsis DLL_THREAD_ATTACH adl�.

Bir ortam havuzu i� par�ac�� bu tasar�m koyarsan�z, her zaman kullan�labilir bellek ayr�lamad�.

Bellek ay�rma en iyi duruma getirmek i�in en iyi yolu �udur:

Do�ru TLS dizin de�erini, DLL_PROCESS_ATTACH i�inde TlsAlloc edinin.
DLL_PROCESS_ATTACH veya DLL_THREAD_ATTACH bellek ayr�lamad�.
TLS de�erini almak i�in genel bir fonksiyonu tasar�m; BO� ise, do�ru olarak, ay�rmak ve TlsSetValue aray�n.

Bu ad�m, bellek ay�rma ger�ekten kullanmak bu i� par�ac�� k�s�tlar. Bu alt i� par�ac�� Genel giderleri ve ba�lang�� saatini �nemli �l��de azaltabilir. Ayr�ca, do�ru yerde LoadLibrary s�rd� �nce k�kenli bu i� par�ac�� i�lemek i�in art�kl�k olu�turur.
DLL_PROCESS_DETACH ve DLL_THREAD_DETACH her zaman olarak adland�r�l�r, ��nk� bu i�lemler belle�i bo�alt�n.

Yine de belirsiz olabilir yaln�zca �ey TlsAlloc �a�r�s� ' dir. Belgeleri okuma, d�nd�r�len TLS dizin de�erini, genel bir de�er oldu�unu g�r�nebilir. Genel bir de�erdir, ancak her bir �a?r? TlaAlloc farkl� bir dizin de�eri verir. Bu, kendi TLS dizin de�erine sahip ve di�erlerini etkilemeden kendi TLS verilerini d�zg�n bir �ekilde i�ler iki geni�letilmi� sakl� yordamlar sa�lar.

A�a��daki �rnekte a��klanan davran�� g�steren bir geni�letilmi� sakl� yordamd�r:

   // 
   //    1. Start SQL Server from the command prompt to see the output:
   //       ...\Mssql\Binn\Sqlservr -c
   // 
   //    2. Run Xproctst.cmd to show the behavior.
   // 
   #include "windows.h"
   #include "stdio.h"
   #include "srv.h"
 
   #define           TLS_FAIL    0xFFFFFFFF

   DWORD          dwTlsIndex     =  TLS_FAIL;
   DWORD          dwCounter      =  0;
   CRITICAL_SECTION  csSync;

   // 
   //    Cleanup TLS memory
   // 
   void vCleanUpTls(void)
   {
      char *   strData     =  NULL;
      if(TLS_FAIL != dwTlsIndex)
      {
         strData = TlsGetValue(dwTlsIndex);
         if(NULL != strData)
         {
            free(strData);
            printf("\n >>> Tls memory released by thread %ld",
   GetCurrentThreadId());
         }
      }
   }
   // 
   //    Setup the TLS pointer
   // 
   void vSetUpTls(void)
   {
      char *      strData  =  NULL;
      if(TLS_FAIL == dwTlsIndex)
      {
         dwTlsIndex = TlsAlloc();
      }
      // 
      //    Are we ready to go
      // 
      if(TLS_FAIL != dwTlsIndex)
      {
         strData = (char *) calloc(256,1);
         if(strData)
         {
            printf("\n >>> Tls memory allocated by thread %ld",
   GetCurrentThreadId());
            if(TRUE == TlsSetValue(dwTlsIndex, strData))
            {
               // 
               //    Protect the counter.
               // 
               EnterCriticalSection(&csSync);
               sprintf(strData, "Counter = %ld", ++dwCounter);
               LeaveCriticalSection(&csSync);
            }
            else
            {
               printf("\n >>> *** Serious error *** TlsSetValue
               failed.\n");
            }
         }
         else
         {
            printf("\n >>> *** Serious error *** can not allocate
            memory.\n");
         }
      }
      else
      {
         printf("\n >>> *** Serious error *** TlsAlloc failed.\n");
      }
   }
   // 
   //    DLLMain
   // 
   BOOL APIENTRY DllMain(HANDLE hInst, ULONG ul_reason_for_call, LPVOID
   lpReserved)
   {
      char  strInfo[256]   =  "";
      switch(ul_reason_for_call)
      {
         case DLL_PROCESS_ATTACH:
            InitializeCriticalSection(&csSync);
            vSetUpTls();
            sprintf(strInfo, "\n >>> DLL_PROCESS_ATTACH Thread: %ld",
   GetCurrentThreadId());
            break;
        case DLL_THREAD_ATTACH:
            vSetUpTls();
            sprintf(strInfo, "\n >>> DLL_THREAD_ATTACH Thread: %ld",
   GetCurrentThreadId());
            break;
         case DLL_PROCESS_DETACH:
            vCleanUpTls();
            if(TLS_FAIL != dwTlsIndex)
               TlsFree(dwTlsIndex);
            DeleteCriticalSection(&csSync);
            sprintf(strInfo, "\n >>> DLL_PROCESS_DETACH Thread: %ld",
   GetCurrentThreadId());
            break;
         case DLL_THREAD_DETACH:
            vCleanUpTls();
            sprintf(strInfo, "\n >>> DLL_THREAD_DETACH Thread: %ld",
   GetCurrentThreadId());
            break;
      }
      printf(strInfo);
      return TRUE;
   }
   // 
   //    DLL function in the extended stored procedure to show TLS trap
   // 
   __declspec(dllexport) SRVRETCODE xp_Tls(SRV_PROC *pSrvProc)
   {
      char  strInfo[256]   =  "";
      char *   strData        =  NULL;
      sprintf(strInfo, "\n >>> Invoking xp_Tls on Thread: %ld",
   GetCurrentThreadId());
      printf(strInfo);
      if(TLS_FAIL != dwTlsIndex)
      {
         strData = TlsGetValue(dwTlsIndex);
         if(NULL != strData)
         {
            sprintf(strInfo, "\n >>> %s", strData);
            printf(strInfo);
         }
         else
         {
            printf("\n >>> *** Serious error *** TlsGetValue returned NULL,
   thread pooling not handled correctly.\n");
         }
      }
      return 1;
   }

�ste

Daha fazla bilgi

SQL Server 7.0 ve SQL Server 2000 Fiber

Biz kesinlikle TLS kullanarak engelleyin ve fiber modunda TLS kullanan tekrar yapmay� desteklemez. Fiber modunda, herhangi bir TLS g�venli de�il hale getirme, �e�itli nedenlerle fiziksel i� par�ac��n�n de�i�tirilebilir.

�ste

Bu makaledeki bilginin uyguland�� durum:

Microsoft SQL Server 2000 Enterprise Edition
Microsoft SQL Server 7.0 Standard Edition
Microsoft SQL Server 6.0 Standard Edition
Microsoft SQL Server 6.5 Standard Edition

�ste

kbmt kbhowto kbother kbprogramming kbusage KB163449 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:163449� (http://support.microsoft.com/kb/163449/en-us/ )

�ste

This site in other countries/regions:

Bir geni�letilmi� sakl� yordam� i� par�ac�� yerel depolama kullan�mda

Bu Sayfada

�zet

Daha fazla bilgi

Daha fazla bilgi

SQL Server 7.0 ve SQL Server 2000 Fiber

Bu makaledeki bilginin uyguland�� durum:

Anahtar Kelimeler:�

Di�er Destek Siteleri

Topluluk

Hemen Yard�m Al

Makale �evirileri

�lgili Destek Merkezleri

This site in other countries/regions:

Bir geni�letilmi� sakl� yordam� i� par�ac��� yerel depolama kullan�mda

Bu Sayfada

�zet

Daha fazla bilgi

Daha fazla bilgi

SQL Server 7.0 ve SQL Server 2000 Fiber

Bu makaledeki bilginin uyguland��� durum:

Anahtar Kelimeler:�

Di�er Destek Siteleri

Topluluk

Hemen Yard�m Al

Makale �evirileri

�lgili Destek Merkezleri

Bir geni�letilmi� sakl� yordam� i� par�ac�� yerel depolama kullan�mda

Bu makaledeki bilginin uyguland�� durum: