Come implementare una funzione di callback di SQL Server 2000 Desktop Engine e di esempio

Il presente articolo è stato tradotto tramite il software di traduzione automatica di Microsoft e non da una persona. Microsoft offre sia articoli tradotti da persone fisiche sia articoli tradotti automaticamente da un software, in modo da rendere disponibili tutti gli articoli presenti nella nostra Knowledge Base nella lingua madre dell’utente. Tuttavia, un articolo tradotto in modo automatico non è sempre perfetto. Potrebbe contenere errori di sintassi, di grammatica o di utilizzo dei vocaboli, più o meno allo stesso modo di come una persona straniera potrebbe commettere degli errori parlando una lingua che non è la sua. Microsoft non è responsabile di alcuna imprecisione, errore o danno cagionato da qualsiasi traduzione non corretta dei contenuti o dell’utilizzo degli stessi fatto dai propri clienti. Microsoft, inoltre, aggiorna frequentemente il software di traduzione automatica.

315463
Questo articolo è stato archiviato. L’articolo, quindi, viene offerto “così come è” e non verrà più aggiornato.
Sommario
In questo articolo viene descritto come implementare una funzione di richiamata durante l'installazione di SQL Server 2000 Desktop Engine (MSDE 2000) e vengono inoltre illustrate tutte le condizioni che devono essere soddisfatti per assicurarsi che la funzione di callback viene eseguito correttamente.

SQL Server 2000 Desktop Engine (MSDE 2000) è una versione ridistribuibile del motore di relazionali del database di Microsoft SQL Server 2000. Consente a un'applicazione che utilizza il motore di database relazionale di SQL Server per installare il modulo di gestione come parte del processo di installazione dell'applicazione.

Pacchetto di installazione di MSDE 2000 consente di utilizzare una funzione di callback per tenere traccia dello stato di avanzamento o per eseguire azioni personalizzate durante l'installazione.

back to the top

Condizioni per l'utilizzo della funzione di callback

Per la funzione callback a funzionare normalmente, è necessario soddisfare le seguenti condizioni:
  • È necessario implementare la funzione di callback come un Windows Installer Custom azione tipo 1 collegato libreria dinamico (DLL). Ad esempio, è possibile utilizzare guidata di Microsoft Visual c ++ Extended Stored Procedure per creare un DLL di callback.

    Per ulteriori informazioni sui tipi di libreria di Windows Installer, visitare il seguente sito Web MSDN (informazioni in lingua inglese):
  • La funzione di callback deve risiedere in una qualsiasi delle seguenti cartelle:
    • La cartella che viene restituita dalla chiamata GetTempPath Win32.
    • La cartella {Product code} presente nella cartella che viene restituita dalla chiamata GetTempPath Win32.

      Nota {Product code} è un segnaposto per il codice di prodotto dell'istanza di MSDE 2000 installata nel computer.
    In genere, la cartella che viene restituita da Win32 GetTempPath chiamata è la variabile di ambiente % TMP % . Se la variabile di ambiente % TMP % non è disponibile, è la variabile di ambiente % TEMP % .

    Per ulteriori informazioni sulla funzione Win32 GetTempPath , visitare il seguente sito Web MSDN (informazioni in lingua inglese):
  • La funzione di callback di Desktop Engine deve richiedere un parametro aggiuntivo UINT che contiene il codice di uscita di Desktop Engine oppure codice di ritorno. La definizione di una funzione di callback è simile a
    UINT __stdcall MyCallbackFunction(MSIHANDLE hinstall, UINT uExitCode)						
    dove uExitCode contiene l'installazione di Desktop Engine codice di uscita o restituire il codice.

back to the top

Istruzioni di esempio e codice per implementare una funzione di callback

Di seguito viene descritta l'implementazione di una funzione di callback di esempio utilizzando Microsoft Visual Studio 6.0.

  1. Nell'IDE di Microsoft Visual c ++ 6.0, fare clic su file e quindi fare clic sul pulsante Nuovo . Nella scheda progetti , fare clic su procedura guidata stored procedure estesa.
  2. Specificare un nome di progetto. Ad esempio, MyCallback . È inoltre possibile specificare il percorso in cui si desidera creare il progetto. Fare clic su OK .
  3. Specificare un nome per la funzione di callback. Ad esempio, MyCallbackFunction . Si noti che l'esempio utilizza la creazione guidata stored procedure estesa per creare un DLL di callback. La procedura guidata si consiglia che è specificare il nome inizia con "XP_". Tuttavia, è possibile ignorare la raccomandazione e specificare il nome della funzione callback di propria scelta. Fare clic su Fine .
  4. Verrà creato le classi e i file cpp necessari. Area di lavoro per il progetto verrà visualizzato nel riquadro area di lavoro. Selezionare la visualizzazione delle classi e quindi espandere la cartella Globals nella struttura della MyCallback classi . Non esiste verrà visualizzata la definizione della funzione MyCallbackFunction .

    Il codice di esempio per la funzione di richiamata è nell'intestazione del Codice di esempio riportato di seguito. È possibile verificare il progetto copiando il codice riportato di seguito nella funzione MyCallbackFunction .

    Codice di esempio

    #include <stdafx.h>#define XP_NOERROR 0#define XP_ERROR 1#define MAXCOLNAME 25#define MAXNAME 25#define MAXTEXT 255#ifdef __cplusplusextern "C" {#endifUINT __declspec(dllexport) MyCallbackFunction(HANDLE hinstall, UINT uExitCode);#ifdef __cplusplus}#endifUINT __declspec(dllexport) MyCallbackFunction(HANDLE hinstall, UINT uExitCode){     TCHAR buffer[1024];     wsprintf(buffer, TEXT("**Callback** Return code is %d"), uExitCode);     MessageBox(NULL, buffer, TEXT("MyCallbackFunction Dialog"), MB_OK);     return 0;}					
    Questo esempio di funzione di callback visualizzato un messaggio con il testo a ogni chiamata:
    **Callback** Return code is 0					
  5. Generare il file di MyCallback.dll utilizzando il menu Genera . La DLL viene generata e salvata in una sottocartella denominata debug , nella stessa posizione specificata nel passaggio 2.
  6. Dopo che la DLL è stata generata, è necessario copiare la DLL in una posizione dipende dalla versione di MSDE 2000 installata nel computer.
    • Se si utilizza SQL Server 2000 Desktop Engine SP2, è necessario copiare la DLL nel percorso è definito da uno dei seguenti variabili di ambiente:
      • % TMP %
      • % TEMP % .
      Per ottenere l'ambiente per i valori delle variabili su un computer specifico per l'utente attualmente connesso, digitare il seguente comando al prompt dei comandi di:
      SET
      Questo comando Visualizza tutte le variabili di ambiente, inclusi TMP e TEMP .
    • Se si utilizza SQL Server 2000 Desktop Engine SP3a, è necessario copiare la DLL a uno dei seguenti percorsi:
      • %TMP%\ {Product code}
      • %TEMP%\ {Product code}
      Nota {Product code} è un segnaposto per il codice di prodotto dell'istanza di MSDE 2000 installata nel computer.

      Ad esempio, se l'istanza di MSDE 2000 dispone di un codice di prodotto di E09B48B5-E141-427A-AB0C-D3605127224A, è necessario copiare la DLL di % TMP%\{E09B48B5-E141-427A-AB0C-D3605127224A} o % TEMP%\{E09B48B5-E141-427A-AB0C-D3605127224A} cartella.
  7. Utilizzare l'opzione di Windows Installer CALLBACK di Desktop Engine per richiamare la funzione di richiamata durante l'installazione. Ad esempio:
    CALLBACK=Dllname!CallbackFunctionName
    per questo esempio la sintassi è:
    setup.exe /L*v c:\msde_setup.log CALLBACK=MyCallback!MyCallbackFunction					

back to the top
Riferimenti
Per ulteriori informazioni, fare clic sul numero dell'articolo della Microsoft Knowledge Base riportato di seguito riportato:
299795Come creare pacchetti di installazione di MSDE 2000 con Microsoft Visual Studio Installer 1.1


Windows Installer SDK fa parte di Microsoft Platform Software Development Kit (SDK). Per ulteriori informazioni su Platform SDK, visitare il sito di Web di Microsoft:Documentazione in linea di SQL Server 2000; gli argomenti: "Building SQL Server Applications"; "Distribuzione di SQL Server Applications"; "Distribuzione SQL Server con Applications", "Desktop Engine Windows Installer codici di ritorno"; "Desktop Engine Windows Installer funzioni di callback"
back to the top
MSDE callback funzione uExitCode kbAudDeveloper kbSQLServ2000Search kbZNotKeyword5 kbSQLServSearch

Avviso: questo articolo è stato tradotto automaticamente

Proprietà

ID articolo: 315463 - Ultima revisione: 02/14/2014 02:07:34 - Revisione: 3.0

  • Microsoft SQL Server 2000 Desktop Engine (MSDE) SP3a
  • Microsoft SQL Server 2000 Desktop Engine (Windows)
  • kbnosurvey kbarchive kbmt kbhowtomaster KB315463 KbMtit
Feedback