Données Unicode et pages de codes du serveur

S’applique à : SQL Server

Important

Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez l'intégration CLR à la place.

L'API de procédure stockée étendue est activée pour les données Unicode ; toutefois, elle n'est pas activée pour les métadonnées Unicode. La directive Unicode #define n'a pas d'effet sur l'API de procédure stockée étendue.

Toutes les métadonnées retournées par l'API de procédure stockée étendue ou fournies par celle-ci à par votre application de procédure stockée étendue sont censées figurer dans la page de codes multioctets du serveur. La page de codes par défaut d’une application serveur d’API de procédure stockée étendue est la page de codes ANSI de l’ordinateur sur lequel l’application est en cours d’exécution, ce qui peut être obtenu en appelant srv_pfield avec le paramètre de champ défini sur SRV_SPROC_CODEPAGE.

Si votre application de l'API de procédure stockée étendue prend en charge Unicode, vous devez convertir les noms de colonne de métadonnées Unicode, les messages d'erreur, etc. en données multioctets avant de passer ces données à l'API de procédure stockée étendue.

Exemple

La procédure stockée étendue suivante est un exemple des conversions Unicode abordées précédemment. Notez les points suivants :

• Les données de colonne sont transmises en tant que données Unicode à srv_describe , car la colonne est décrite comme étant SRVNVARCHAR.

• Les métadonnées de nom de colonne sont passées à srv_describe en tant que données multioctets.

  Les appels de procédure stockée étendue srv_pfield avec le paramètre de champ défini sur SRV_SPROC_CODEPAGE pour obtenir la page de codes multioctets de Microsoft SQL Server.

• Les messages d’erreur sont passés à srv_sendmsg en tant que données multioctets.

  __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;  
  }  
  
  

Voir aussi

srv_wsendmsg (API de procédure stockée étendue)