Funzione di callback ENUMRESTYPEPROCA (libloaderapi.h)

Articolo
08/24/2023

Funzione di callback definita dall'applicazione usata con le funzioni EnumResourceTypes e EnumResourceTypesEx . Riceve 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 al modulo il cui file eseguibile contiene le risorse per cui i tipi devono essere enumerati. Se questo parametro è NULL, la funzione enumera i tipi di risorse 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 intero 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 arrestare l'enumerazione.

Commenti

Se IS_INTRESOURCE(lpszType) è TRUE, lpszType specifica l'identificatore intero 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 sterlina (#), i caratteri rimanenti rappresentano un numero decimale che specifica l'identificatore intero del tipo di risorsa. Ad esempio, la stringa "#258" rappresenta l'identificatore 258.

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

Se la funzione callback restituisce FALSE, EnumResourceTypes o EnumResourceTypesEx arresterà l'enumerazione e restituirà FALSE. In Windows XP e in precedenza il valore ottenuto da GetLastError sarà 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	libloaderapi.h (includere Windows.h)