Funzione WritePrivateProfileStringW (winbase.h)

• Assicurarsi che nel sistema non esista alcun file .ini del nome specificato.
• Assicurarsi che nel Registro di sistema sia presente una voce chiave che specifica il file .ini. Questa voce deve trovarsi nel percorso HKEY_LOCAL_MACHINE\SOFTWARE \Microsoft\Windows NT\CurrentVersion\IniFileMapping.
• Specificare un valore per tale .ini voce di chiave del file che specifica una sezione. Vale a dire, un'applicazione deve specificare un nome di sezione, come apparirebbe all'interno di un file .ini o voce del Registro di sistema. Di seguito è riportato un esempio: [Sezione personale].
• Per i file di sistema, specificare SYS per un valore aggiunto.
• Per i file dell'applicazione, specificare USR all'interno del valore aggiunto. Ecco un esempio: "My Section: USR: App Name\Section". Inoltre, poiché USR indica un mapping in HKEY_CURRENT_USER, l'applicazione deve anche creare una chiave in HKEY_CURRENT_USER che specifica il nome dell'applicazione elencato nel valore aggiunto. Per l'esempio appena specificato, sarebbe "Nome app".
• Dopo aver seguito i passaggi precedenti, un programma di installazione dell'applicazione deve chiamare WritePrivateProfileString con i primi tre parametri impostati su NULLe il quarto parametro impostato sul nome file INI. Per esempio:

  WritePrivateProfileString( NULL, NULL, NULL, L"appname.ini" );

• Tale chiamata fa sì che il mapping di un file .ini al Registro di sistema venga applicato prima del successivo riavvio del sistema. Il sistema rilegge le informazioni di mapping nella memoria condivisa. Un utente non dovrà riavviare il computer dopo l'installazione di un'applicazione per fare in modo che le chiamate future dell'applicazione visualizzino il mapping del file .ini al Registro di sistema.

Esempi

Il codice di esempio seguente illustra le linee guida precedenti ed è basato su diversi presupposti:

• Esiste un'applicazione denominata Nome app.
• Tale applicazione usa un file di .ini denominato AppName.ini.
• È presente una sezione nel file .ini che si vuole avere un aspetto simile al seguente:

  [Section1] 
    FirstKey = It all worked out okay. 
    SecondKey = By golly, it works. 
    ThirdKey = Another test.
  

• L'utente non dovrà riavviare il sistema per fare in modo che le chiamate future dell'applicazione visualizzino il mapping del file .ini al Registro di sistema.

#include <windows.h> 
#include <tchar.h>
#include <stdio.h> 
 
int main() 
{ 
   TCHAR   inBuf[80]; 
   HKEY   hKey1, hKey2; 
   DWORD  dwDisposition; 
   LONG   lRetCode; 
   TCHAR   szData[] = TEXT("USR:App Name\\Section1");
 
   // Create the .ini file key. 
   lRetCode = RegCreateKeyEx ( HKEY_LOCAL_MACHINE, 
       TEXT("SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\IniFileMapping\\appname.ini"), 
       0, 
       NULL, 
       REG_OPTION_NON_VOLATILE, 
       KEY_WRITE, 
       NULL, 
       &hKey1, 
       &dwDisposition); 
 
   if (lRetCode != ERROR_SUCCESS)
   { 
      printf ("Error in creating appname.ini key (%d).\n", lRetCode); 
      return (0) ; 
   } 
 
   // Set a section value 
   lRetCode = RegSetValueEx ( hKey1, 
                              TEXT("Section1"), 
                              0, 
                              REG_SZ, 
                              (BYTE *)szData, 
                              sizeof(szData)); 
 
   if (lRetCode != ERROR_SUCCESS) 
   { 
      printf ("Error in setting Section1 value\n"); 
      // Close the key
      lRetCode = RegCloseKey( hKey1 );
      if( lRetCode != ERROR_SUCCESS )
      {
         printf("Error in RegCloseKey (%d).\n", lRetCode);
         return (0) ; 
      }
   } 
 
   // Create an App Name key 
   lRetCode = RegCreateKeyEx ( HKEY_CURRENT_USER, 
                               TEXT("App Name"), 
                               0, 
                               NULL, 
                               REG_OPTION_NON_VOLATILE,
                               KEY_WRITE, 
                               NULL, 
                               &hKey2, 
                               &dwDisposition); 
 
   if (lRetCode != ERROR_SUCCESS) 
   { 
      printf ("Error in creating App Name key (%d).\n", lRetCode); 

      // Close the key
      lRetCode = RegCloseKey( hKey2 );
      if( lRetCode != ERROR_SUCCESS )
      {
         printf("Error in RegCloseKey (%d).\n", lRetCode);
         return (0) ; 
      }
   } 
 
   // Force the system to read the mapping into shared memory 
   // so that future invocations of the application will see it 
   // without the user having to reboot the system 
   WritePrivateProfileStringW( NULL, NULL, NULL, L"appname.ini" ); 
 
   // Write some added values 
   WritePrivateProfileString (TEXT("Section1"), 
                              TEXT("FirstKey"), 
                              TEXT("It all worked out OK."), 
                              TEXT("appname.ini")); 
   WritePrivateProfileString (TEXT("Section1"), 
                              TEXT("SecondKey"), 
                              TEXT("By golly, it works!"), 
                              TEXT("appname.ini")); 
   WritePrivateProfileString (TEXT("Section1"), 
                              TEXT("ThirdKey"), 
                              TEXT("Another test..."), 
                              TEXT("appname.ini")); 

   // Test 
   GetPrivateProfileString (TEXT("Section1"), 
                            TEXT("FirstKey"), 
                            TEXT("Error: GPPS failed"), 
                            inBuf, 
                            80, 
                            TEXT("appname.ini")); 
   _tprintf (TEXT("Key: %s\n"), inBuf); 
 
   // Close the keys
   lRetCode = RegCloseKey( hKey1 );
   if( lRetCode != ERROR_SUCCESS )
   {
      printf("Error in RegCloseKey (%d).\n", lRetCode);
      return(0);
   }

   lRetCode = RegCloseKey( hKey2 );
   if( lRetCode != ERROR_SUCCESS )
   {
      printf("Error in RegCloseKey (%d).\n", lRetCode);
      return(0);
   }
   
   return(1); 
}

Fabbisogno

Vedere anche

GetPrivateProfileString

WriteProfileString