Schreiben einer Windows XP-Anwendung, die Benutzer- und Anwendungsdaten unter dem korrekten Pfad speichert

• Erstellen einer Win32-Anwendung.
• Hinzufügen einer Option Speichern unter zum Menü Datei.
• Verwenden des Standard-Dialogfelds Datei speichern für Verweis auf Standardpfad.
• Überprüfen des korrekten Pfads für Datei speichern.
• Erinnern der vorherigen Benutzerauswahl.
• Überprüfen der vorherigen Benutzerauswahl.

• Klassifizieren von Anwendungsdaten.
• Speichern von Anwendungsdaten unter dem korrekten Pfad.
• Umsichtiges Verwenden der Registrierung.

Zum Anfang

Voraussetzungen

• Windows XP Home Edition oder Windows XP Professional
• Microsoft Visual Studio .NET oder Visual Studio 6.0
• Vorkenntnisse zur Win32-Anwendungsentwicklung

Zum Anfang

Erstellen einer Win32-Anwendung

• Wählen Sie in Visual C++ 6.0 aus der Liste der verfügbaren Projekttypen Win32-Anwendung und anschließend im Setup-Assistenten für Anwendungen die Option für eine typische "Hello World"--Anwendung aus.
• Klicken Sie in Visual Studio .NET unter Projekttypen auf Visual C++-Projekte und anschließend unter Vorlagen auf Win32-Projekt. Akzeptieren Sie die vom Application Setup Wizard angezeigten Standard-Anwendungseinstellungen.

Zum Anfang

Hinzufügen einer Option Speichern unter zum Menü Datei

1. Klicken Sie auf Ressourcenansicht und doppelklicken Sie anschließend auf IDC_SAVINGDATA.
2. Fügen Sie eine Menüoption Speichern unter zum Menü Datei hinzu. Verwenden Sie IDM_FILE_SAVEAS als ID des Menüelements.
3. Suchen Sie die WndProc-Fensterprozedur der Anwendung in SavingData.cppm und fügen Sie eine neue case-Anweisung zum Abschnitt WM_COMMAND hinzu, um die Menüoption Speichern unter zu verarbeiten. Rufen Sie die OnFileSaveAs-Funktion auf, die Sie im nächsten Abschnitt erstellen werden. Diese Funktion benötigt keine Parameter.
   
   Ihr Code sollte folgendermaßen aussehen:

   case WM_COMMAND:
      wmId    = LOWORD(wParam); 
      wmEvent = HIWORD(wParam); 
      // Parse the menu selections.
      switch (wmId)
      {
      case IDM_ABOUT:
         DialogBox(hInst, (LPCTSTR)IDD_ABOUTBOX, hWnd, (DLGPROC)About);
         break;
      case IDM_EXIT:
         DestroyWindow(hWnd);
         break;
      case IDM_FILE_SAVEAS:
         OnFileSaveAs();
         break;
      default:
         return DefWindowProc(hWnd, message, wParam, lParam);
      }
      break;

Zum Anfang

Verwenden des Standard-Dialogfelds Datei speichern für Verweis auf Standardpfad.

1. Fügen Sie am Anfang von SavingData.cpp die folgenden include-Anweisungen hinzu:

   #include <commdlg.h>   // for GetSaveFileName
   #include <shlobj.h>    // for SHGetFolderPath

2. Fügen Sie den folgenden Prototyp für die OnFileSaveAs-Funktion hinzu:

   void OnFileSaveAs();

3. Erstellen Sie die neue OnFileSaveAs-Funktion. Verwenden Sie in dieser Funktion die SHGetFolderPath-Funktion zusammen mit dem CSIDL_MYPICTURESCSIDL-Bezeichner, um den korrekten Ordnerpfad für die Speicherung von Bilddaten abzurufen. Übergeben Sie diesen Ordnerpfad an die GetSaveFileName-Funktion, um das Standard-Dialogfeld Datei speichern anzuzeigen.
   
   Ihr Code sollte folgendermaßen aussehen:

   void OnFileSaveAs()
   {
      OPENFILENAME openFile;
      TCHAR szPath[MAX_PATH];
   
   // Initialize OPENFILENAME structure.
   ZeroMemory( &openFile, sizeof(OPENFILENAME) );
   openFile.lStructSize = sizeof(OPENFILENAME);
   // Default to My Pictures. First, get its path.
   if ( SUCCEEDED( SHGetFolderPath( NULL, CSIDL_MYPICTURES, 
                                         NULL, 0, szPath ) ) )
   {
      // Set lpstrInitialDir to the path that SHGetFolderPath obtains. 
      // This causes GetSaveFileName to point to the My Pictures folder.
         openFile.lpstrInitialDir = szPath;
   }
   // Display the standard File Save dialog box, defaulting to My Pictures.
   if ( GetSaveFileName( &openFile ) == TRUE )
   {
         // User clicks the Save button.
      // Save the file
   }
   else
   {
      // User cancels the File Save dialog box.
   }
   }

Zum Anfang

Überprüfen des korrekten Pfads für Datei speichern

1. Drücken Sie die Taste [F5], um das Projekt zu erstellen.
2. Führen Sie die Anwendung aus und klicken Sie im Menü Datei auf Speichern unter.
3. Überprüfen Sie, ob das Standard-Dialogfeld Datei speichern standardmäßig auf den Ordner Eigene Bilder verweist, wie durch CSIDL_MYPICTURES angegeben.
4. Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen, und schließen Sie die Anwendung.

Zum Anfang

Erinnern der vorherigen Benutzerauswahl

1. Erstellen Sie in der OnFileSaveAs-Funktion eine statische boolsche Variable mit dem Namen bFirstSave und setzen Sie sie anfänglich auf TRUE.
2. Ändern Sie den Code in OnFileSaveAs so, dass SHGetFolderPath nur aufgerufen und der lpstrInitialDir-Member der OPENFILENAME-Struktur nur gesetzt wird, wenn bFirstSave den Wert TRUE hat.
3. Wenn der Benutzer im Dialogfeld Datei speichern auf Speichern klickt, setzen Sie bFirstSaveauf FALSE.
   
   Ihr Code sollte folgendermaßen aussehen:

   void OnFileSaveAs()
   {
      OPENFILENAME openFile;
      TCHAR szPath[MAX_PATH];
      static BOOL bFirstSave = TRUE;
   
   // Initialize OPENFILENAME structure.
   ZeroMemory( &openFile, sizeof(OPENFILENAME) );
   openFile.lStructSize = sizeof(OPENFILENAME);
   // The first time the user saves a document, default to My Pictures.
      if ( TRUE == bFirstSave )
   {
      if ( SUCCEEDED( SHGetFolderPath( NULL, CSIDL_MYPICTURES, 
                                            NULL, 0, szPath ) ) )
      {
            // Set lpstrInitialDir to the path that SHGetFolderPath obtains.
            // This causes GetSaveFileName to point to the My Pictures folder.
            openFile.lpstrInitialDir = szPath;
      }
   }
   // Display standard File Save dialog box, defaulting to My Pictures
   // or the user's previously selected location.
   if ( GetSaveFileName( &openFile ) == TRUE )
   {
      // User clicks Save.
      // Save the file.
         bFirstSave = FALSE;
   }
   else
   {
         // User cancels the File Save dialog box.
   }
   }

Zum Anfang

Überprüfen der vorherigen Benutzerauswahl

1. Erstellen Sie das Projekt und führen Sie die Anwendung aus.
2. Klicken Sie im Menü Datei auf Speichern unter.
3. Gehen Sie vom Ordner Eigene Bilder zum Ordner Eigene Dateien, wählen Sie eine Datei aus und klicken Sie auf Speichern.
4. Klicken Sie im Menü Datei erneut auf Speichern unter.
5. Überprüfen Sie, ob das Dialogfeld standardmäßig auf die vorherige Auswahl (in diesem Fall Eigene Dateien) verweist.
6. Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen, und schließen Sie die Anwendung.
7. Führen Sie die Anwendung aus und klicken Sie im Menü Datei auf Speichern unter.
8. Überprüfen Sie, ob das Dialogfeld wieder auf den Ordner Eigene Bilder verweist.
9. Schließen Sie das Dialogfeld und beenden Sie die Anwendung.

Zum Anfang

Klassifizieren von Anwendungsdaten

• Für einzelnen Benutzer (servergespeichert): Diese Kategorie umfasst Anwendungsdaten, die sich speziell auf einen bestimmten Benutzer beziehen und auch dann verfügbar sein sollten, wenn dieser Benutzer den Computer innerhalb einer Domäne wechselt (zum Beispiel ein Benutzerwörterbuch). Beachten Sie, dass diese Einstellung nicht für Anwendungen gilt, die nicht für die Ausführung in einer Domänenumgebung vorgesehen sind.
• Für einzelnen Benutzer (nicht servergespeichert): Diese Kategorie umfasst Anwendungsdaten, die sich speziell auf einen bestimmten Benutzer beziehen und nur für einen einzigen Computer gelten (zum Beispiel eine benutzerdefinierte Bildschirmauflösung).
• Für einzelnen Computer (nicht benutzerspezifisch und nicht servergespeichert): Diese Kategorie umfasst Anwendungsdaten, die sich auf alle Benutzer, aber nur auf einen speziellen Computer beziehen (zum Beispiel ein Anwendungswörterbuch, eine Protokolldatei oder eine temporäre Datei).

Zum Anfang

Speichern von Anwendungsdaten unter korrektem Pfad

• Verwenden Sie für Daten "Für einzelnen Benutzer (servergespeichert)" den CSIDL_APPDATA-Wert. Dieser verweist standardmäßig auf den folgenden Pfad:
  \Dokumente und Einstellungen\<Benutzername>\Anwendungsdaten
• Verwenden Sie für Daten "Für einzelnen Benutzer (nicht servergespeichert)" den CSIDL_LOCAL_APPDATA-Wert. Dieser verweist standardmäßig auf den folgenden Pfad:
  \Dokumente und Einstellungen\<Benutzername>\Lokale Einstellungen\Anwendungsdaten
• Verwenden Sie für Daten "Für einzelnen Computer (nicht benutzerspezifisch und nicht servergespeichert)" den CSIDL_COMMON_APPDATA-Wert. Dieser verweist standardmäßig auf den folgenden Pfad:
  \Dokumente und Einstellungen\All Users\Anwendungsdaten

void CreateTemporaryFile()
{
   TCHAR szPath[MAX_PATH];
   // Get path for each computer, non-user specific and non-roaming data.
   if ( SUCCEEDED( SHGetFolderPath( NULL, CSIDL_COMMON_APPDATA, 
                                    NULL, 0, szPath ) ) )
   {
      TCHAR szTempFileName[MAX_PATH];
      // Append product-specific path.
      PathAppend( szPath, "\\My Company\\My Product\\1.0\\" );
      // Generate a temporary file name within this folder.
      if (GetTempFileName( szPath, 
                           "PRE",
                           0,
                           szTempFileName ) != 0 )
      {
         HANDLE hFile = NULL;
         // Open the file.
         if (( hFile = CreateFile( szTempFileName, 
                                     GENERIC_WRITE, 
                                     0, 
                                   NULL, 
                                   CREATE_ALWAYS, 
                                   FILE_ATTRIBUTE_NORMAL, 
                                   NULL )) != INVALID_HANDLE_VALUE )
         {
            // Write temporary data (code omitted).
            CloseHandle( hFile );
         }
      }
   }
}

Zum Anfang

Umsichtiges Verwenden der Registrierung

• Verwenden Sie für kleine Mengen von Benutzerdaten den Registrierungsschlüssel HKEY_CURRENT_USER (HKCU).
• Verwenden Sie für kleine Mengen von Computerdaten den Registrierungsschlüssel HKEY_LOCAL_MACHINE (HKLM). Ihre Anwendung sollte nicht zur Laufzeit in HKLM schreiben, weil Benutzer, die keine Administratoren sind, standardmäßig nur Lesezugriff auf die HKLM-Struktur haben.
• Zur Installationszeit darf Ihre Anwendung nicht mehr als insgesamt 128 KB unter HKCU und HKLM speichern.
• Component Object Model (COM)-Komponenten werden unter dem Registrierungsschlüssel HKEY_CLASSES_ROOT (HKCR) registriert. Der Maximalwert von 128 KB schließt HKCR nicht ein.
• Wenn Sie in HKLM oder HKCU schreiben, müssen Sie wie folgt Schlüssel für den Firmennamen, den Produktnamen und die Produktversion schreiben:
  HKLM\Software\Firmenname\Produktname\Produktversion
  HKCU\Software\Firmenname\Produktname\Produktversion
• Verwenden Sie die Registrierungsfunktionen (wie RegCreateKeyEx und RegSetValueEx), um Registrierungseinträge zu lesen und zu schreiben.

Zum Anfang

Problembehandlung

• Um sicherzustellen, dass Anwendungen nicht nur auf Windows XP, sondern auch auf früheren Windows-Versionen laufen, stellen Sie immer eine Verknüpfung zur SHGetFolderPath-Implementierung in Shfolder.dll her. Windows XP enthält zwar SHGetFolderPath in Shell32.dll, jedoch unterstützen frühere Versionen von Windows möglicherweise nicht die Funktion in dieser Dynamic-Link Library (DLL).
• Shfolder.dll ist eine verteilbare Komponente und kann unter Ihren Anwendungen verteilt werden.
• Speichern Sie keine vollqualifizierten Pfade zum Ordner Eigene Dateien (oder anderen Systemordnern) in einem anwendungsspezifischen Ordner wie einer Liste der zuletzt verwendeten Dateien: Ein Benutzer oder Administrator kann diese Ordner zwischen aufeinanderfolgenden Verwendungen Ihrer Anwendung verschieben.

Zum Anfang