/H (Restringir la longitud de los nombres externos)
Restringe la longitud de los nombres externos
/Hnumber
Argumentos
- number
Especifica la longitud máxima permitida para los nombres externos en un programa.
Comentarios
De forma predeterminada, la longitud de los nombres externos (públicos) es de 2.047 caracteres.Esto ocurre tanto en C como en C++.El uso de /H sólo puede disminuir la longitud máxima permitida para los identificadores, no aumentarla.Un espacio entre /H y number es opcional.
Si un programa contiene nombres externos más largos que number, los caracteres adicionales se omiten.Si compila un programa sin /H y un identificador contiene más de 2.047 caracteres, el compilador generará Error irrecuperable C1064.
En el límite de longitud se incluye cualquier signo inicial de subrayado (_) o signo de arroba (@) creado por el compilador.Estos caracteres forman parte del identificador y ocupan una ubicación significativa.
El compilador agrega un carácter de subrayado inicial (_) a los nombres modificados por las convenciones de llamadas __cdecl (valor predeterminado) y __stdcall, y un signo de arroba inicial (@) a los nombres modificados por la convención de llamadas __fastcall.
El compilador anexa información de tamaño de los argumentos a los nombres modificados por las convenciones de llamadas __fastcall y __stdcall, y agrega información de tipo a los nombres de C++.
Encontrará /H útil:
Si crea programas en varios idiomas o programas portables.
Si usa herramientas que imponen límites a la longitud de los identificadores externos.
Si desea restringir el espacio que usan los símbolos en una versión de depuración.
En el ejemplo siguiente se muestra cómo el uso de /H puede causar errores si se limita demasiado la longitud de los identificadores:
// compiler_option_H.cpp
// compile with: /H5
// processor: x86
// LNK2005 expected
void func1(void);
void func2(void);
int main() { func1(); }
void func1(void) {}
void func2(void) {}
También debe tener cuidado, cuando use la opción /H, con los identificadores de compilador predefinidos.Si la longitud máxima de los identificadores es demasiado pequeña, algunos identificadores predefinidos no se resolverán, lo mismo que determinadas llamadas a funciones de biblioteca.Por ejemplo, si se utiliza la función printf y se especifica la opción /H5 en tiempo de compilación, se creará el símbolo _prin para hacer referencia a printf y ésta no se encontrará en la biblioteca.
El uso de /H es incompatible con /GL (Optimización de todo el programa).
La opción /H ha quedado desusada; se han aumentado los límites de longitud máximos y ya no se necesita /H.Para obtener más información, vea Deprecated Compiler Options.
Para establecer esta opción del compilador en el entorno de desarrollo de Visual Studio
Abra el cuadro de diálogo Páginas de propiedades del proyecto.Para obtener información detallada, vea Cómo: Abrir páginas de propiedades del proyecto.
Haga clic en la carpeta C/C++.
Haga clic en la página de propiedades Línea de comandos.
Escriba la opción del compilador en el cuadro Opciones adicionales.
Para establecer esta opción del compilador mediante programación
- Vea AdditionalOptions.