Funzione di callback ENUMRESTYPEPROCA (libloaderapi.h)

Articolo
11/20/2024

Funzione di callback definita dall'applicazione usata con le funzioni EnumResourceTypes e EnumResourceTypesEx. Riceve i tipi di risorse. Il tipo ENUMRESTYPEPROC definisce un puntatore a questa funzione di callback. EnumResTypeProc è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

ENUMRESTYPEPROCA Enumrestypeproca;

BOOL Enumrestypeproca(
  [in, optional] HMODULE hModule,
                 LPSTR lpType,
  [in]           LONG_PTR lParam
)
{...}

Parametri

[in, optional] hModule

Tipo: HMODULE

Handle del modulo il cui file eseguibile contiene le risorse per le quali devono essere enumerati i tipi. Se questo parametro è NULL, la funzione enumera i tipi di risorsa nel modulo usato per creare il processo corrente.

lpType

Tipo: LPTSTR

Tipo di risorsa per cui viene enumerato il tipo.

In alternativa, anziché un puntatore, questo parametro può essere MAKEINTRESOURCE(ID), dove ID è l'identificatore integer del tipo di risorsa specificato. Per i tipi di risorse standard, vedere tipi di risorse. Per altre informazioni, vedere la sezione Osservazioni di seguito.

[in] lParam

Tipo: LONG_PTR

Parametro definito dall'applicazione passato alla funzione EnumResourceTypes o EnumResourceTypesEx. Questo parametro può essere usato nel controllo degli errori.

Valore restituito

Tipo: bool

Restituisce TRUE per continuare l'enumerazione o FALSE per interrompere l'enumerazione.

Osservazioni

Se IS_INTRESOURCE(lpszType) è TRUE, lpszType specifica l'identificatore integer del tipo di risorsa specificato. In caso contrario, è un puntatore a una stringa con terminazione Null. Se il primo carattere della stringa è un segno di cancelletto (#), i caratteri rimanenti rappresentano un numero decimale che specifica l'identificatore integer del tipo di risorsa. Ad esempio, la stringa "#258" rappresenta l'identificatore 258.

Un'applicazione deve registrare questa funzione passando il relativo indirizzo alla funzione EnumResourceTypes o EnumResourceTypesEx.

Se la funzione di callback restituisce FALSE, EnumResourceTypes o EnumResourceTypesEx interromperà l'enumerazione e restituirà FALSE. In Windows XP e versioni precedenti il valore ottenuto da GetLastError verrà ERROR_SUCCESS; a partire da Windows Vista, l'ultimo valore di errore sarà ERROR_RESOURCE_ENUM_USER_STOP.

Nota

L'intestazione libloaderapi.h definisce ENUMRESTYPEPROC 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	libloaderapi.h (include Windows.h)