Compartir a través de

Función StrToInt64ExW (shlwapi.h)

  • Artículo

Convierte una cadena que representa un valor decimal o hexadecimal en un entero de 64 bits.

Sintaxis

BOOL StrToInt64ExW(
  [in]  PCWSTR     pszString,
        STIF_FLAGS dwFlags,
  [out] LONGLONG   *pllRet
);

Parámetros

[in] pszString

Tipo: PCTSTR

Puntero a la cadena terminada en null que se va a convertir. Para obtener más información sobre las formas válidas de la cadena, vea la sección Comentarios.

dwFlags

Tipo: STIF_FLAGS

Uno de los siguientes valores que especifican cómo se debe analizar pszString para su conversión a un entero de 64 bits.

STIF_DEFAULT

La cadena de pszString contiene la representación de un valor decimal.

STIF_SUPPORT_HEX

La cadena de pszString contiene la representación de un valor decimal o hexadecimal. Tenga en cuenta que, en representaciones hexadecimales, los caracteres A-F no distinguen mayúsculas de minúsculas.

[out] pllRet

Tipo: LONGLONG*

Puntero a una variable de tipo LONGLONG que recibe el valor entero de 64 bits de la cadena convertida. Por ejemplo, en el caso de la cadena "123", el entero al que apunta este valor recibe el valor 123.

Si esta función devuelve FALSE, este valor no está definido.

Si el valor devuelto es demasiado grande para estar contenido en una variable de tipo LONGLONG, este parámetro contiene los 64 bits de orden bajo del valor. Cualquier bits de orden superior más allá de eso se pierde.

Valor devuelto

Tipo: BOOL

Devuelve TRUE si la cadena se convierte; en caso contrario , FALSE.

Comentarios

La cadena a la que apunta el parámetro pszString debe tener uno de los siguientes formularios para analizarse correctamente.

  • Este formulario se acepta como un valor decimal en cualquiera de las marcas. Sintaxis ''' (espacio en blanco opcional)(signo opcional)(uno o varios dígitos decimales) '''
  • Estos formularios son necesarios para los valores hexadecimales cuando se pasa la marca STIF_SUPPORT_HEX. Sintaxis ''' (espacio en blanco opcional)(signo opcional)0x(uno o varios dígitos hexadecimales) '''
    (optional white space)(optional sign)0X(one or more hexadecimal digits)
El signo opcional puede ser el carácter '-' o '+'; si se omite, se supone que el signo es positivo.
Nota Si el valor se analiza como hexadecimal, se omite el signo opcional, aunque sea un carácter "-". Por ejemplo, la cadena "-0x1" se analiza como 1 en lugar de -1.
 
Si la cadena a la que apunta pszString contiene un carácter no válido, ese carácter se considera el final de la cadena que se va a convertir y se omite el resto. Por ejemplo, dado que la cadena hexadecimal no válida "0x00am123", StrToInt64Ex solo reconoce "0x00a", la convierte en el valor entero 10 y devuelve TRUE.

Si pllRet es NULL, la función devuelve TRUE si se puede convertir la cadena, aunque no realice la conversión.

Nota

El encabezado shlwapi.h define StrToInt64Ex como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 5.0 o posterior)