Dane Unicode i stron kodowych serwera

Ważne:
Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Nie należy stosować tej funkcji w nowych projektach oraz jak najszybciej należy zmodyfikować aplikacje, w których obecnie jest używana ta funkcja. Użyj integracji CLR.

API rozszerzone procedury przechowywane jest włączona dla danych Unicode; nie jest on jednak włączona metadane Unicode.# Define Unicode dyrektywa nie ma wpływu na API rozszerzone procedury przechowywane.

Zakłada, że wszystkie metadane zwracane przez lub pod warunkiem że API rozszerzona procedura składowana przez aplikację rozszerzona procedura składowana w strona kodowa wielobajtowych serwera.Domyślna strona kodowa aplikacji server Extended API procedury przechowywane jest strona kodowa ANSI komputera, na którym uruchomiona jest aplikacja, który można uzyskać przez wywołanie srv_pfield z parametrem pole zestaw do SRV_SPROC_CODEPAGE.

Jeżeli aplikacja API procedury przechowywane rozszerzone obsługuje standard Unicode, należy przekonwertować metadane Unicode kolumna nazwy, komunikaty o błędach i wielobajtowych danych przed przekazaniem danych do API rozszerzone procedury przechowywane itd.

Przykład

Następujące rozszerzona procedura składowana zawiera przykład omówiono konwersje Unicode.Należy zauważyć, że:

• Kolumna danych jest przekazywany jako dane Unicode do srv_describe , ponieważ kolumna jest opisany się SRVNVARCHAR.

• Kolumny Nazwa metadane jest przekazywana do srv_describe jako dane wielobajtowych.

  The extended stored procedure calls srv_pfield with the field parameter set to SRV_SPROC_CODEPAGE to obtain the multibyte code page of Microsoft SQL Server.

• Komunikaty o błędach są przekazywane do srv_sendmsg jako dane wielobajtowych.

  __declspec(dllexport) RETCODE proc1 (SRV_PROC *srvproc)
  {
      #define MAX_COL_NAME_LEN 25
      #define MAX_COL_DATA_LEN 50
      #define MAX_ERR_MSG_LEN 250
      #define MAX_SERVER_ERROR 20000
      #define XP_ERROR_NUMBER MAX_SERVER_ERROR+1
  
      int retval;
      UINT serverCodePage;
      CHAR *szServerCodePage;
  
      WCHAR unicodeColumnName[MAX_COL_NAME_LEN];
      CHAR multibyteColumnName[MAX_COL_NAME_LEN];
  
      WCHAR unicodeColumnData[MAX_COL_DATA_LEN];
  
      WCHAR unicodeErrorMessage[MAX_ERR_MSG_LEN];
      CHAR  multibyteErrorMessage[MAX_ERR_MSG_LEN];
  
      lstrcpyW (unicodeColumnName, L"column1");
      lstrcpyW (unicodeColumnData, L"column1 data");
      lstrcpyW (unicodeErrorMessage, L"No Error!");
  
      // Obtain server code page.
      //
      szServerCodePage = srv_pfield (srvproc, SRV_SPROC_CODEPAGE, NULL);    
      if (NULL != szServerCodePage)
          serverCodePage = atol(szServerCodePage);
      else 
      {   // Problem situation exists.
          srv_senddone(srvproc, (SRV_DONE_ERROR | SRV_DONE_MORE), 0, 0);
          return 1;
      }
  
      // Convert column name for Unicode to multibyte using the 
      // server code page.
      //
      retval = WideCharToMultiByte(  
          serverCodePage,                 // code page
          0,                              // default
          unicodeColumnName,              // wide-character string
          -1,                             // string is null terminated
          multibyteColumnName,            // address of buffer for new
                                          //   string
          sizeof (multibyteColumnName),   // size of buffer
          NULL, NULL);
  
      if (0 == retval)
      {
          lstrcpyW (unicodeErrorMessage, L"Conversion to multibyte
          failed.");
          goto Error;
      }
  
      retval = srv_describe (srvproc, 1, multibyteColumnName,
      SRV_NULLTERM, 
        SRVNVARCHAR, MAX_COL_DATA_LEN*sizeof(WCHAR), // destination
          SRVNVARCHAR, lstrlenW(unicodeColumnData)*sizeof(WCHAR),
          unicodeColumnData); //source
      if (FAIL == retval)
      {
          lstrcpyW (unicodeErrorMessage, L"srv_describe failed.");
          goto Error;
      }
  
     retval = srv_sendrow(srvproc);
      if (FAIL == retval)
      {
          lstrcpyW (unicodeErrorMessage, L"srv_sendrow failed.");
          goto Error;
      }
  
      retval = srv_senddone (srvproc, SRV_DONE_MORE|SRV_DONE_COUNT, 0, 1);
      if (FAIL == retval)
      {
          lstrcpyW (unicodeErrorMessage, L"srv_senddone failed.");
          goto Error;
      }
  
      return 0;
  Error:
      // convert error message from Unicode to multibyte.
      retval = WideCharToMultiByte(  
          serverCodePage,                 // code page
          0,                              // default
          unicodeErrorMessage,            // wide-character string
          -1,                             // string is null terminated
          multibyteErrorMessage,          // address of buffer for new
                                          //   string
          sizeof (multibyteErrorMessage), // size of buffer
          NULL, NULL);
  
  srv_sendmsg(srvproc, SRV_MSG_ERROR, XP_ERROR_NUMBER, SRV_INFO, 1,
              NULL, 0, __LINE__, 
              multibyteErrorMessage,
              SRV_NULLTERM);
  
      srv_senddone(srvproc, (SRV_DONE_ERROR | SRV_DONE_MORE), 0, 0);
  
      return 1;
  }
  

Zobacz także

Odwołanie

srv_wsendmsg (Extended przechowywane procedury API)