Esempio di chiamata a un'API
Aggiornamento: novembre 2007
In questo esempio viene illustrato come chiamare le funzioni dell'API Win32 per l'enumerazione e il controllo di processi e finestre e per la ricerca e la modifica di impostazioni del sistema.
Per ottenere esempi e istruzioni per la relativa installazione
Effettuare una delle seguenti operazioni:
Dal menu Guida, scegliere Esempi.
Il file Readme contiene informazioni sugli esempi.
Visitare il sito Web Visual Studio 2008 Samples (informazioni in lingua inglese). Su tale sito sono disponibili le versioni più recenti degli esempi.
Individuare gli esempi sul computer in cui è installato Visual Studio. Il percorso di installazione predefinito degli esempi e del file Readme relativo è unità:\Programmi\Microsoft Visual Studio 9.0\Samples\lcid. Per le versioni Express di Visual Studio tutti gli esempi sono disponibili in linea.
Per ulteriori informazioni, vedere Individuazione dei file di esempio.
.gif "Nota sulla sicurezza") Nota sulla sicurezza: |
|---|
In questo esempio di codice viene illustrato un concetto e viene presentato solo il codice rilevante. È possibile che questo esempio non soddisfi i requisiti di sicurezza per un ambiente specifico ed è opportuno non utilizzarlo così come viene riportato. È consigliabile aggiungere codice relativo alla sicurezza e alla gestione degli errori per rendere i progetti più sicuri e potenti. Microsoft fornisce questo esempio di codice "COSÌ COM'È" senza garanzie. |
Per eseguire l'esempio
- Premere F5.
Dimostrazione
La classe Win32API è definita in un file distinto, Win32API.vb. Ogni dichiarazione dell'API, che utilizza l'Istruzione Declare, è disponibile come membro Shared della classe Win32API. È possibile chiamare direttamente i membri condivisi utilizzando il nome della classe. Per utilizzarli non è necessario creare un'istanza della classe.
Il form principale contiene un controllo Struttura a schede con quattro schede. In ogni scheda viene illustrata un'azione mediante chiamate all'API Win32:
Active Processes Riempie una visualizzazione Elenco con tutti i processi Windows in esecuzione. Viene illustrato l'utilizzo di una funzione di richiamata Win32, EnumWindows, mediante un delegato.
Active Windows Riempie il controllo ListBox con tutte le finestre attive filtrando i risultati della funzione di callback, EnumWindows, mediante l'API Win32. In questo esempio EnumWindows viene definita utilizzando la classe DllImportAttribute anziché l'Istruzione Declare per evidenziare la differenza tra i due metodi.
Show Window Consente all'utente di digitare il nome della classe e/o la didascalia di una finestra e portare la finestra in primo piano. In questo esempio viene illustrato l'overload di più tipi di parametri di una funzione dell'API Win32 per consentire il passaggio di vari tipi di variabile alla funzione.
API Calls Viene illustrato come utilizzare le seguenti chiamate all'API Win32: GetDiskFreeSpace, GetDiskFreeSpaceEx, GetDriveType, CreateDirectory, SwapMouseButton, IsPwrHibernateAllowed, SetSuspendState e Beep. Sono esempi di chiamate che restituiscono informazioni che non possono essere ottenute tramite chiamate equivalenti di classi gestite.