_configthreadlocale

Configurar las opciones de configuración regional por subproceso.

Sintaxis

int _configthreadlocale( int per_thread_locale_type );

Parámetros

per_thread_locale_type
Opción que se va a establecer. Una de las opciones que se citan en la tabla siguiente.

Valor devuelto

Estado anterior de la configuración regional por subproceso (_DISABLE_PER_THREAD_LOCALE o _ENABLE_PER_THREAD_LOCALE), o -1 si se produce un error.

Comentarios

La función _configthreadlocale se utiliza para controlar el uso de configuraciones regionales específicas de subproceso. Use una de estas opciones per_thread_locale_type para especificar o determinar el estado de la configuración regional por subproceso:

Opción	Descripción
_ENABLE_PER_THREAD_LOCALE	Hace que el subproceso actual use una configuración regional específica del subproceso. Las llamadas subsiguientes a setlocale en este subproceso solo afectan a la configuración regional propia del subproceso.
_DISABLE_PER_THREAD_LOCALE	Hace que el subproceso actual use la configuración regional global. Las llamadas subsiguientes a setlocale en este subproceso afectan a los demás subprocesos que usen la configuración regional global.
0	Recupera el valor actual de este subproceso concreto.

Estas funciones afectan al comportamiento de setlocale, _tsetlocale, _wsetlocale y _setmbcp. Cuando se deshabilita la configuración regional por subproceso, cualquier llamada subsiguiente a setlocale o _wsetlocale cambia la configuración regional de todos los subprocesos que usan la configuración regional global. Cuando se habilita la configuración regional por subproceso, setlocale o _wsetlocale afecta solo a la configuración regional del subproceso actual.

Si usa _configthreadlocale para habilitar una configuración regional por subproceso, establezca la configuración regional preferida en ese subproceso inmediatamente después de una llamada a setlocale o _wsetlocale.

Si per_thread_locale_type no es uno de los valores enumerados en la tabla, esta función invoca al controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, esta función establece errno en EINVAL y devuelve -1.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Routine	Encabezado necesario
_configthreadlocale	`<locale.h>`

Ejemplo

// crt_configthreadlocale.cpp
//
// This program demonstrates the use of _configthreadlocale when
// using two independent threads.
//
// Compile by using: cl /EHsc /W4 crt_configthreadlocale.cpp

#include <locale.h>
#include <mbctype.h>
#include <process.h>
#include <windows.h>
#include <stdio.h>
#include <time.h>

#define BUFF_SIZE 100

// Retrieve the date and time in the current
// locale's format.
int get_time(unsigned char* str)
{
    __time64_t  ltime;
    struct tm   thetime;

    // Retieve the time
    _time64(&ltime);
    _gmtime64_s(&thetime, &ltime);

    // Format the current time structure into a string
    // using %#x is the long date representation,
    // appropriate to the current locale
    if (!strftime((char *)str, BUFF_SIZE, "%#x",
                  (const struct tm*)&thetime))
    {
        printf("strftime failed!\n");
        return -1;
    }
    return 0;
}

// This thread sets its locale to German
// and prints the time.
unsigned __stdcall SecondThreadFunc( void* /*pArguments*/ )
{
    unsigned char str[BUFF_SIZE];

    _configthreadlocale(_ENABLE_PER_THREAD_LOCALE);

    // Set the thread code page
    _setmbcp(_MB_CP_ANSI);

    // Set the thread locale
    printf("The thread locale is now set to %s.\n",
           setlocale(LC_ALL, "German"));

    // Retrieve the time string from the helper function
    if (get_time(str) == 0)
    {
        printf("The time in German locale is: '%s'\n", str);
    }

    _endthreadex( 0 );
    return 0;
}

// The main thread spawns a second thread (above) and then
// sets the locale to English and prints the time.
int main()
{
    HANDLE          hThread;
    unsigned        threadID;
    unsigned char   str[BUFF_SIZE];

    // Enable per-thread locale causes all subsequent locale
    // setting changes in this thread to only affect this thread.
    _configthreadlocale(_ENABLE_PER_THREAD_LOCALE);

    // Retrieve the time string from the helper function
    printf("The thread locale is now set to %s.\n",
           setlocale(LC_ALL, "English"));

    // Create the second thread.
    hThread = (HANDLE)_beginthreadex( NULL, 0, &SecondThreadFunc,
                                      NULL, 0, &threadID );

    if (get_time(str) == 0)
    {
        // Retrieve the time string from the helper function
        printf("The time in English locale is: '%s'\n\n", str);
    }

    // Wait for the created thread to finish.
    WaitForSingleObject( hThread, INFINITE );

    // Destroy the thread object.
    CloseHandle( hThread );
}

The thread locale is now set to English_United States.1252.
The time in English locale is: 'Wednesday, May 12, 2004'

The thread locale is now set to German_Germany.1252.
The time in German locale is: 'Mittwoch, 12. Mai 2004'

Vea también

setlocale, _wsetlocale
_beginthread, _beginthreadex
Configuración regional
Multithreading y configuraciones regionales