Unicode 数据和服务器代码页

适用范围：SQL Server

重要

在 SQL Server的未来版本中将删除此功能。 请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。 请改用 CLR 集成。

为 Unicode 数据启用了扩展存储过程 API;但是，它未为 Unicode 元数据启用。 #define Unicode 指令对扩展存储过程 API 没有任何影响。

由扩展存储过程 API 返回的或由您的扩展存储过程应用程序提供给它的所有元数据都假定位于服务器的多字节代码页中。 扩展存储过程 API 服务器应用程序的默认代码页是运行应用程序的计算机的 ANSI 代码页，可通过调用 srv_pfield 字段参数设置为该 SRV_SPROC_CODEPAGE页来获取。

如果您的扩展存储过程 API 应用程序启用了 Unicode，则必须将您的 Unicode 元数据列名称、错误消息等转换为多字节数据，然后才能将该数据传递给扩展存储过程 API。

示例

以下扩展存储过程提供了上述 Unicode 转换的示例。

• 列数据作为 Unicode 数据 srv_describe 传递给，因为该列描述为 SRVNVARCHAR。

• 列名元数据作为多字节数据传递到 srv_describe 。

  扩展存储过程调用 srv_pfield 的字段参数设置为 SRV_SPROC_CODEPAGE 获取 SQL Server 的多字节代码页。

• 错误消息作为 srv_sendmsg 多字节数据传递到。

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

相关内容

• srv_wsendmsg（扩展存储过程 API）