Compartilhar via

Dados Unicode e páginas de código do servidor

  • Artigo

Aplica-se: SQL Server

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Em vez disso, use a Integração CLR.

A API de Procedimento Armazenado Estendido está habilitada para dados Unicode; no entanto, ele não está habilitado para metadados Unicode. A #define diretiva Unicode não tem nenhum efeito na API de Procedimento Armazenado Estendido.

Pressupõe-se que todos os metadados retornados pela API de procedimento armazenado estendido ou fornecidos para ela pelo seu aplicativo de procedimento armazenado estendido estejam na página de código multibyte do servidor. A página de código padrão de um aplicativo de servidor de API de Procedimento Armazenado Estendido é a página de código ANSI do computador no qual o aplicativo está sendo executado, que pode ser obtida chamando srv_pfield com o parâmetro de campo definido como SRV_SPROC_CODEPAGE.

Se seu aplicativo de API de procedimento armazenado estendido for compatível com Unicode, você deverá converter os nomes das colunas de metadados Unicode, as mensagens de erro e assim por diante em dados multibyte antes de passar esses dados para a API de procedimento armazenado estendido.

Exemplos

O procedimento armazenado estendido a seguir fornece um exemplo de conversões de Unicode.

  • Os dados da coluna são passados como dados Unicode para srv_describe porque a coluna é descrita como SRVNVARCHAR.

  • Os metadados do nome da coluna são passados como srv_describe dados multibyte.

    O procedimento armazenado estendido chama srv_pfield com o parâmetro de campo definido como SRV_SPROC_CODEPAGE para obter a página de código multibyte do SQL Server.

  • As mensagens de erro são passadas como srv_sendmsg dados multibyte.

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

Conteúdo relacionado