Funzione GetPrivateProfileStructW (winbase.h)

Articolo
11/20/2024

Recupera i dati associati a una chiave nella sezione specificata di un file di inizializzazione. Durante il recupero dei dati, la funzione calcola un checksum e la confronta con il checksum calcolato dalla funzione WritePrivateProfileStruct quando i dati sono stati aggiunti al file.

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

Sintassi

BOOL GetPrivateProfileStructW(
  [in]  LPCWSTR lpszSection,
  [in]  LPCWSTR lpszKey,
  [out] LPVOID  lpStruct,
  [in]  UINT    uSizeStruct,
  [in]  LPCWSTR szFile
);

Parametri

[in] lpszSection

Nome della sezione nel file di inizializzazione.

[in] lpszKey

Nome della chiave di cui recuperare i dati.

[out] lpStruct

Puntatore al buffer che riceve i dati associati al file, alla sezione e ai nomi delle chiavi.

[in] uSizeStruct

Dimensioni del buffer a cui punta il parametro lpStruct in byte.

[in] szFile

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

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Osservazioni

Una sezione del file di inizializzazione deve avere il formato seguente:

[section]
key=data
      .
      .
      .

Il sistema esegue il mapping della maggior parte dei riferimenti di file .ini al Registro di sistema usando il mapping definito nella chiave del Registro di sistema seguente: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.inie Winfile.ini. In questi casi, la funzione recupera le 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, ad esempio MyFile.ini, in IniFileMapping.
Cercare il nome della sezione specificato da lpAppName. Questo sarà un valore denominato in myfile.inio una sottochiave di myfile.inio non esisterà.
Se il nome della sezione specificato da lpAppName è un valore denominato in myfile.ini, tale valore specifica dove nel Registro di sistema si troveranno le chiavi per la sezione.
Se il nome della sezione specificato da lpAppName è una sottochiave di myfile.ini, i valori denominati nella 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 in myfile.ini, sarà presente un valore senza nome (visualizzato come <No Name>) in myfile.ini che specifica il percorso predefinito nel Registro di sistema in cui si troveranno le chiavi per la sezione.
Se non è presente alcuna sottochiave myfile.ini o se non contiene una voce per il nome della sezione, cercare il MyFile.ini effettivo sul disco e leggerne il contenuto.

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

! : 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 GetPrivateProfileStruct 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

Vedere anche

writePrivateProfileStruct

Condividi tramite