Funzione di callback PROPENUMPROCEXA (winuser.h)

Articolo
11/20/2024

Funzione di callback definita dall'applicazione usata con la funzione EnumPropsEx . La funzione riceve le voci di proprietà dall'elenco delle proprietà di una finestra. Il tipo PROPENUMPROCEX definisce un puntatore a questa funzione di callback. PropEnumProcEx è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PROPENUMPROCEXA Propenumprocexa;

BOOL Propenumprocexa(
  HWND unnamedParam1,
  LPSTR unnamedParam2,
  HANDLE unnamedParam3,
  ULONG_PTR unnamedParam4
)
{...}

Parametri

unnamedParam1

Tipo: HWND

Handle per la finestra di cui è in corso l'enumerazione dell'elenco di proprietà.

unnamedParam2

Tipo: LPTSTR

Componente stringa di una voce dell'elenco di proprietà. Si tratta della stringa specificata, insieme a un handle di dati, quando la proprietà è stata aggiunta all'elenco delle proprietà della finestra tramite una chiamata alla funzione SetProp.

unnamedParam3

Tipo: HANDLE

Handle per i dati. Questo handle è il componente dati di una voce dell'elenco di proprietà.

unnamedParam4

Tipo: ULONG_PTR

Dati definiti dall'applicazione. Si tratta del valore specificato come parametro lParam della chiamata a EnumPropsEx che ha avviato l'enumerazione.

Valore restituito

Tipo: bool

Restituisce true per continuare l'enumerazione dell'elenco delle proprietà.

Restituisce FALSE per arrestare l'enumerazione dell'elenco di proprietà.

Osservazioni

A questa funzione di callback si applicano le restrizioni seguenti:

La funzione di callback può chiamare la funzione RemoveProp . Tuttavia, RemoveProp può rimuovere solo la proprietà passata alla funzione di callback tramite i parametri della funzione di callback.
La funzione di callback non deve tentare di aggiungere proprietà.

Nota

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