Funzione GetProfileSectionW (winbase.h)
Recupera tutte le chiavi e i valori per la sezione specificata del file Win.ini.
Sintassi
DWORD GetProfileSectionW(
[in] LPCWSTR lpAppName,
[out] LPWSTR lpReturnedString,
[in] DWORD nSize
);
Parametri
[in] lpAppName
Nome della sezione nel file Win.ini.
[out] lpReturnedString
Puntatore a un buffer che riceve le chiavi e i valori associati alla sezione denominata. Il buffer viene riempito con una o più stringhe con terminazione Null; l'ultima stringa è seguita da un secondo carattere Null.
[in] nSize
Dimensioni del buffer a cui punta il parametro lpReturnedString, in caratteri.
La dimensione massima della sezione del profilo è di 32.767 caratteri.
Valore restituito
Il valore restituito specifica il numero di caratteri copiati nel buffer specificato, senza includere il carattere Null di terminazione. Se il buffer non è sufficientemente grande da contenere tutte le chiavi e i valori associati alla sezione denominata, il valore restituito è uguale alle dimensioni specificate da nSize meno due.
Osservazioni
Il formato delle chiavi e dei valori restituiti è una o più stringhe con terminazione Null, seguite da un carattere Null finale. Ogni stringa ha il formato seguente: chiave=stringa
La funzione GetProfileSection
Questa operazione è atomica; non sono consentiti aggiornamenti al file Win.ini mentre le chiavi e i valori per la sezione vengono copiati nel buffer.
Windows Server 2003 e Windows XP/2000: Le chiamate alle funzioni di profilo possono essere mappate al Registro di sistema anziché ai file di inizializzazione. Questo mapping si verifica quando il file di inizializzazione e la sezione vengono specificati nel Registro di sistema sotto la chiave seguente: HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\IniFileMapping.
Quando l'operazione è stata mappata, la funzione GetProfileSection 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:
- Cercare nel Registro di sistema il nome del file di inizializzazione nella chiave IniFileMapping.
- Cercare il nome della sezione specificato da lpAppName. Si tratta di un valore denominato nella chiave con il nome del file di inizializzazione o di una sottochiave con questo nome oppure il nome non esisterà come valore o sottochiave.
- Se il nome della sezione specificato da lpAppName è un valore denominato, tale valore specifica dove nel Registro di sistema troverai le chiavi per la sezione.
- Se il nome della sezione specificato da lpAppName è una sottochiave, i valori denominati in tale sottochiave specificano dove nel Registro di sistema si troveranno 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 il percorso predefinito nel Registro di sistema in cui si trova la chiave.
- 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 il percorso predefinito nel Registro di sistema in cui si troveranno le chiavi per la sezione.
- Se non è presente alcuna sottochiave o voce per il nome della sezione, cercare il file di inizializzazione effettivo sul disco e leggerne il contenuto.
- ! : questo carattere forza tutte le scritture a passare sia al Registro di sistema che al file .ini su disco.
- # : questo carattere fa sì che il valore del Registro di sistema venga impostato sul valore nel file di 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 .ini su disco se i dati richiesti non vengono trovati nel Registro di sistema.
- USR: questo prefisso è l'acronimo di HKEY_CURRENT_USERe il testo dopo il prefisso è relativo a tale chiave.
- SYS: questo prefisso è l'acronimo di HKEY_LOCAL_MACHINE\SOFTWAREe il testo dopo il prefisso è relativo a tale chiave.
Nota
L'intestazione winbase.h definisce GetProfileSection come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 2000 Professional [solo app desktop] |
| server minimo supportato | Windows 2000 Server [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
winbase.h (include Windows.h) |
| libreria |
Kernel32.lib |
| dll | Kernel32.dll |