Come compilare esempi
Per compilare un esempio COM, l'ambiente computer deve essere configurato per compilare applicazioni Microsoft Win32 C++.
Preparazione di un computer per la creazione di esempi COM
L'ambiente computer deve essere configurato con un compilatore C++ a 32 bit installato correttamente, un linker e un compilatore di risorse compatibili con Microsoft Visual C++ 4.x o versione successiva e un Windows SDK installato correttamente. È consigliabile installare Windows SDK per ultimo. Windows SDK fornisce file di inclusione .h e file di libreria .lib necessari per la funzionalità COM codificata negli esempi.
Per eseguire correttamente gli esempi Remclien, Freserve e Freclien, sono necessarie funzionalità di sistema disponibili nei sistemi operativi Windows: Windows Server 2003, Windows XP, Windows 2000 o Windows NT 4.0. Gli esempi Remclien, Freserve e Freclien verranno compilati ma non verranno eseguiti nei sistemi operativi Windows Me, Windows 98 o Windows 95, a meno che Distributed COM (DCOM) e COM a thread libero non facciano parte del sistema operativo. Questo supporto è disponibile per i sistemi operativi Windows Me, Windows 98 e Windows 95 nel componente aggiuntivo DCOM95.
Ogni directory di esempio include i file di origine necessari per compilare ed eseguire l'esempio. La directory del campione principale contiene un file Makeall.bat, che è possibile eseguire dal prompt dei comandi per compilare tutti i campioni di codice nel ramo sottostante. Per altre informazioni, vedere il file Makeall.bat. Se l'ambiente è configurato per compilare applicazioni C++ Win32, è sufficiente eseguire Makeall.bat dalla directory in cui risiede per compilare tutti gli esempi di codice nel ramo seguente. Makeall garantisce l'ordine corretto per la compilazione in modo che tutte le dipendenze di esempio di codice siano soddisfatte.
La directory principale include anche un makefile che compila tutti gli esempi di codice dell'esercitazione usando opzioni simili a quelle supportate da Makeall.bat. Per altre informazioni, vedere questo makefile. Questo makefile presuppone che l'intero ramo degli esempi di codice sia installato come parte di Windows SDK. Attualmente questo percorso ha un percorso simile a D:\MSSDK\SAMPLES\COM\TUTSAMP, dove D: rappresenta l'unità di installazione. Se si è estratto il ramo di codice di esempio dell'esercitazione (ad esempio, la directory COM COM e le sue sottodirectory) in un'altra posizione al di fuori del Windows SDK (o se si è ottenuto il set di esempi come download separato dal sito Web di Microsoft), utilizzare Makeall.bat per compilare tutti gli esempi nel ramo. In generale, è consigliabile Makeall.bat. Viene inoltre fornito un file Logmall.bat. Equivale al batch file Makeall, ad eccezione del fatto che registra tutti gli output di compilazione nel file Errorlog.txt nella directory principale del tutorial.
Nella directory principale sono disponibili due file batch, Regall.bat e Unregall.bat, per registrare e deregistrare tutti i server COM nella serie di esempi di codice dell'esercitazione. Per registrare tutti i server, eseguire Regall.bat file dalla directory principale. Per annullare la registrazione di tutti i server, eseguire Unregall.bat nello stesso modo. Questi file batch richiedono una compilazione precedente degli esempi di codice REGISTER, MARSHAL, DLLSERVE, LICSERVE, LOCSERVE, APTSERVE, FRESERVE e CONSERVE. Se si esegue una normale compilazione degli esempi di codice, i makefile del server registrano automaticamente i server. In questo caso, non è necessario eseguire il file batch Regall.
Eseguire il file batch di Cleanall.bat per eseguire una pulizia completa di tutti gli esempi di esercitazioni COM.
Avvertimento
Questo file batch elimina tutti i file di progetto di Visual Studio e altri file di lavoro temporanei creati da Visual C++ negli esempi. Tutti i server COM creati negli esempi di codice dell'esercitazione vengono rimossi dal Registro di sistema. Tutti i file exe eseguibili e .dll vengono eliminati. Tutti i file di simboli di debug vengono eliminati. Vengono eliminati anche i file generati in un'ampia gamma di ambienti di compilazione.
Esegui "Makeall Clean" per una pulizia più veloce, ma meno approfondita, di tutti gli esempi di codice. Questa operazione di pulizia non tenta di essere completa come quella eseguita da Cleanall.bat. I file .obj vengono eliminati, ma i file binari di output vengono conservati. I server COM non vengono cancellati dal Registro di sistema.
Questa serie di esempio ha avuto origine come parte integrante di Windows SDK, pertanto la narrazione dell'esercitazione presuppone un ambiente con Windows SDK installato correttamente.
Tuttavia, le versioni di Microsoft Visual C++ versione 4.0 e successive possono anche fornire i file di libreria con estensione h e lib necessari per la compilazione. In questi casi, l'installazione di Windows SDK potrebbe non essere necessaria per compilare gli esempi.
Per ulteriori informazioni e i dettagli completi della build di esempio, vedere:
Ambiente di configurazione
Estrazione degli esempi di codice
Convenzioni dello stile di codifica