Funzione di callback PROPENUMPROCEXW (winuser.h)

Articolo
03/04/2024

Funzione di callback definita dall'applicazione usata con la funzione EnumPropsEx . La funzione riceve le voci delle 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 definito dall'applicazione.

Sintassi

PROPENUMPROCEXW Propenumprocexw;

BOOL Propenumprocexw(
  HWND unnamedParam1,
  LPWSTR unnamedParam2,
  HANDLE unnamedParam3,
  ULONG_PTR unnamedParam4
)
{...}

Parametri

unnamedParam1

Tipo: HWND

Handle alla finestra di cui viene enumerato l'elenco delle proprietà.

unnamedParam2

Tipo: LPTSTR

Componente stringa di una voce dell'elenco di proprietà. Questa è la 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. Questo è il valore specificato come parametro lParam della chiamata a EnumPropsEx che ha avviato l'enumerazione.

Valore restituito

Tipo: BOOL

Restituire TRUE per continuare l'enumerazione dell'elenco delle proprietà.

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

Commenti

Le restrizioni seguenti si applicano a questa funzione di callback:

La funzione 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 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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)