_get_tzname

Artículo
02/19/2013

Recupera la representación de cadena de caracteres del nombre o el nombre estándar de la zona horaria de la hora luz (DST) de la zona horaria.

errno_t _get_tzname(
    size_t* pReturnValue,
    char* timeZoneName,
    size_t sizeInBytes,
    int index    
);

Parámetros

[out] pReturnValue
La longitud de la cadena de timeZoneName incluido un terminador NULL.
[out] timeZoneName
La dirección de una cadena de caracteres para la representación del nombre o el nombre estándar de la zona horaria de la hora luz (DST) de la zona horaria, dependiendo de index.
[in] sizeInBytes
El tamaño de la cadena de caracteres de timeZoneName en bytes.
[in] index
El índice de uno de los dos nombres de zona horaria a recuperar.

Valor devuelto

Cero si es correcto, si no es un valor de tipo de errno .

Si o timeZoneName es NULL, o sizeInBytes es cero o menor que cero (pero no ambos), se invoca un controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, conjuntos errno de esta función a EINVAL y devuelven EINVAL.

condiciones de error

pReturnValue	timeZoneName	sizeInBytes	index	Valor devuelto	Contenido de timeZoneName
tamaño del nombre de t-z	NULL	0	0 ó 1	0	no modificado
tamaño del nombre de t-z	cualquier	> 0	0 ó 1	0	T-z llama
no modificado	NULL	> 0	cualquier	EINVAL	no modificado
no modificado	cualquier	cero	cualquier	EINVAL	no modificado
no modificado	cualquier	> 0	> 1	EINVAL	no modificado

Comentarios

La función de _get_tzname recupera la representación de cadena de caracteres del nombre o el nombre estándar de la zona horaria de la hora luz (DST) de la zona horaria en la dirección de timeZoneName según el valor de índice, junto con el tamaño de la cadena en pReturnValue.Si timeZoneName es NULL y sizeInBytes es cero, del tamaño de la cadena de cualquier zona horaria de bytes se devuelve en pReturnValue.Los valores de índice deben ser 0 para la zona horaria estándar o 1 para la zona horaria estándar de hora de luz; cualquier otro valor de índice tiene resultados indeterminados.

valores de índice

index	Contenido de timeZoneName	valor predeterminado detimeZoneName
0	nombre de la zona horaria	“PST”
1	Nombre estándar de la zona horaria de la hora luz	“PDT”
> 1 o < 0	errno establecido en EINVAL	no modificado

A menos que los valores explícitamente se cambien durante el tiempo de ejecución, los valores predeterminados son “PST” y “PDT” respectivamente.Los tamaños de estas matrices de caracteres rige el valor de TZNAME_MAX .