Funzione GetPrivateProfileInt (winbase.h)

Recupera un intero associato a una chiave nella sezione specificata di un file di inizializzazione.

Nota Questa funzione viene fornita solo per la compatibilità con applicazioni basate su Windows a 16 bit. Le applicazioni devono archiviare le informazioni di inizializzazione nel Registro di sistema.

 

Sintassi

UINT GetPrivateProfileInt(
  [in] LPCTSTR lpAppName,
  [in] LPCTSTR lpKeyName,
  [in] INT     nDefault,
  [in] LPCTSTR lpFileName
);

Parametri

[in] lpAppName

Nome della sezione nel file di inizializzazione.

[in] lpKeyName

Nome della chiave il cui valore deve essere recuperato. Questo valore è sotto forma di stringa; la funzione GetPrivateProfileInt converte la stringa in un intero e restituisce l'intero.

[in] nDefault

Valore predefinito da restituire se non è possibile trovare il nome della chiave nel file di inizializzazione.

[in] lpFileName

Nome del file di inizializzazione. Se questo parametro non contiene un percorso completo del file, il sistema cerca il file nella directory di Windows.

Valore restituito

Il valore restituito è l'equivalente intero della stringa che segue il nome della chiave specificata nel file di inizializzazione specificato. Se la chiave non viene trovata, il valore restituito è il valore predefinito specificato.

Commenti

La funzione cerca il file per una chiave corrispondente al nome specificato dal parametro lpKeyName sotto il nome della sezione specificato dal parametro lpAppName . Una sezione nel file di inizializzazione deve avere il formato seguente:

[section]
key=value
      .
      .
      .

La funzione GetPrivateProfileInt non è distinzione tra maiuscole e minuscole; le stringhe in lpAppName e lpKeyName possono essere una combinazione di lettere maiuscole e minuscole.

Un'applicazione può usare la funzione GetProfileInt per recuperare un valore intero dal file Win.ini.

Il sistema esegue il mapping della maggior parte dei riferimenti .ini file al Registro di sistema usando il mapping definito nella seguente chiave del Registro di sistema:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\IniFileMapping

Questo mapping è probabile se un'applicazione modifica i file di inizializzazione dei componenti di sistema, ad esempio Control.ini, System.ini e Winfile.ini. In questi casi, la funzione recupera informazioni dal Registro di sistema, non dal file di inizializzazione; la modifica nella posizione di archiviazione non ha alcun effetto sul comportamento della funzione.

Le funzioni del profilo usano i passaggi seguenti per individuare le informazioni di inizializzazione:

1. Cercare nel Registro di sistema il nome del file di inizializzazione nella chiave IniFileMapping .
2. Cercare il nome della sezione specificato da lpAppName. Questo sarà un valore denominato nella chiave con il nome del file di inizializzazione o una sottochiave con questo nome o il nome non esisterà come valore o sottochiave.
3. Se il nome della sezione specificato da lpAppName è un valore denominato, tale valore specifica dove nel Registro di sistema verranno trovate le chiavi per la sezione.
4. Se il nome della sezione specificato da lpAppName è una sottochiave, i valori denominati nella sottochiave specificano dove nel Registro di sistema sono disponibili le chiavi per la sezione. Se la chiave che si sta cercando non esiste come valore denominato, sarà presente un valore senza nome (visualizzato come <Nessun> nome) che specifica la posizione predefinita nel Registro di sistema in cui si troverà la chiave.
5. Se il nome della sezione specificato da lpAppName non esiste come valore denominato o come sottochiave, sarà presente un valore senza nome (visualizzato come <Nessun> nome) che specifica la posizione predefinita nel Registro di sistema in cui saranno disponibili le chiavi per la sezione.
6. Se non è presente alcuna sottochiave o voce per il nome della sezione, cercare il file di inizializzazione effettivo sul disco e leggerne il contenuto.

Quando si esaminano i valori nel Registro di sistema che specificano altre posizioni del Registro di sistema, esistono diversi prefissi che modificano il comportamento del mapping dei file di .ini:

• ! - questo carattere forza tutte le scritture per passare al Registro di sistema e al file .ini su disco.
• # : questo carattere causa l'impostazione del valore del Registro di sistema sul valore nel file windows 3.1 .ini quando un nuovo utente accede per la prima volta dopo l'installazione.
• @ : questo carattere impedisce alle letture di passare al file di .ini su disco se i dati richiesti non vengono trovati nel Registro di sistema.
• USR: questo prefisso è HKEY_CURRENT_USER e il testo dopo il prefisso è relativo a tale chiave.
• SYS: questo prefisso indica HKEY_LOCAL_MACHINE\SOFTWAREe il testo dopo che il prefisso è relativo a tale chiave.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

GetProfileInt

WritePrivateProfileString