Funzione GetConsoleAliasesLength

Articolo
10/23/2023

Importante

Questo documento descrive le funzionalità della piattaforma della console che non fanno più parte della roadmap dell'ecosistema. Non è consigliabile usare questo contenuto nei nuovi prodotti, ma continueremo a supportare gli utilizzi esistenti per il futuro indefinito. La soluzione moderna preferita è incentrata sulle sequenze di terminale virtuale per garantire la massima compatibilità negli scenari multipiattaforma. Per altre informazioni su questa decisione di progettazione, vedere il documento relativo alla console classica e al terminale virtuale.

Recupera le dimensioni necessarie per il buffer usato dalla funzione GetConsoleAliases.

Sintassi

DWORD WINAPI GetConsoleAliasesLength(
  _In_ LPTSTR lpExeName
);

Parametri

lpExeName [in]
Nome del file eseguibile i cui alias della console devono essere recuperati.

Valore restituito

Dimensioni del buffer necessario per archiviare tutti gli alias della console definiti per questo file eseguibile, in byte.

Osservazioni:

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0501 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Suggerimento

Questa API non è consigliata e non ha un terminale virtuale equivalente. Questa decisione allinea intenzionalmente la piattaforma Windows ad altri sistemi operativi in cui l'applicazione client singola che funge da shell o interprete deve mantenere le proprie funzionalità di praticità utente, ad esempio la lettura e il comportamento di manipolazione delle righe, inclusi alias e cronologia dei comandi. Le applicazioni remote tramite utilità multipiattaforma e trasporti come SSH potrebbero non funzionare come previsto se si usa questa API.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	ConsoleApi3.h (tramite WinCon.h, includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll
Nomi Unicode e ANSI	GetConsoleAliasesLengthW (Unicode) e GetConsoleAliasesLengthA (ANSI)