Funzione EnumPageFilesA (psapi.h)
Chiama la routine di callback per ogni pagefile installato nel sistema.
Sintassi
BOOL EnumPageFilesA(
[out] PENUM_PAGE_FILE_CALLBACKA pCallBackRoutine,
[in] LPVOID pContext
);
Parametri
[out] pCallBackRoutine
Puntatore alla routine chiamata per ogni file di paging. Per altre informazioni, vedere EnumPageFilesProc.
[in] pContext
Dati definiti dall'utente passati alla routine di callback.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è TRUE. Se la funzione non riesce, il valore restituito viene FALSE. Per ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
A partire da Windows 7 e Windows Server 2008 R2, Psapi.h stabilisce i numeri di versione per le funzioni PSAPI. Il numero di versione PSAPI influisce sul nome usato per chiamare la funzione e la libreria che un programma deve caricare.
Se PSAPI_VERSION è 2 o versione successiva, questa funzione viene definita come K32EnumPageFiles in Psapi.h ed esportata in Kernel32.lib e Kernel32.dll. Se PSAPI_VERSION è 1, questa funzione viene definita come EnumPageFiles in Psapi.h ed esportata in Psapi.lib e Psapi.dll come wrapper che chiama K32EnumPageFiles.
I programmi che devono essere eseguiti in versioni precedenti di Windows e Windows 7 e versioni successive devono sempre chiamare questa funzione come EnumPageFiles. Per garantire la risoluzione corretta dei simboli, aggiungere Psapi.lib alla macro TARGETLIBS e compilare il programma con –DPSAPI_VERSION=1. Per usare il collegamento dinamico in fase di esecuzione, caricare Psapi.dll.
Nota
L'intestazione psapi.h definisce EnumPageFiles 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 XP [solo app desktop] |
server minimo supportato | Windows Server 2003 [solo app desktop] |
piattaforma di destinazione | Finestre |
intestazione |
psapi.h |
libreria |
Kernel32.lib in Windows 7 e Windows Server 2008 R2; Psapi.lib (se PSAPI_VERSION=1) in Windows 7 e Windows Server 2008 R2; Psapi.lib in Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP |
dll | Kernel32.dll in Windows 7 e Windows Server 2008 R2; Psapi.dll (se PSAPI_VERSION=1) in Windows 7 e Windows Server 2008 R2; Psapi.dll in Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP |