PROPENUMPROCEXA 回呼函式（winuser.h）

與 EnumPropsEx 函式搭配使用的應用程式定義回呼函式。函式會從視窗的屬性清單接收屬性專案。 PROPENUMPROCEX 類型會定義此回呼函式的指標。 PropEnumProcEx 是應用程式定義函式名稱的預留位置。

語法

PROPENUMPROCEXA Propenumprocexa;

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

參數

unnamedParam1

類型：HWND

正在列舉其屬性清單之視窗的控制碼。此參數通常命名為 hWnd。

unnamedParam2

類型： LPTSTR

屬性清單專案的字串元件。這是透過呼叫 SetProp 函式將屬性新增至視窗屬性清單時指定的字串，以及資料控制碼。此參數通常命名為 lpString。

unnamedParam3

類型：手柄

資料的控制碼。此控制碼是屬性清單專案的資料元件。此參數通常命名為 hData。

unnamedParam4

類型： ULONG_PTR

應用程式定義的資料。這是指定為起始列舉之 EnumPropsEx 呼叫之 lParam 參數的值。此參數通常命名為 dwData。

返回值

類型： 布爾值

傳回 TRUE 以繼續屬性清單列舉。

傳回 FALSE 以停止屬性清單列舉。

備註

參數定義在標頭中，沒有名稱： typedef BOOL (CALLBACK* PROPENUMPROCEXA)(HWND, LPSTR, HANDLE, ULONG_PTR);。因此，語法區塊會將它們列為 unnamedParam1 - unnamedParam4。您可以在應用程式中為這些參數命名任何名稱。但是，它們通常按照參數描述中所示命名。

下列限制適用於此回呼函式：

回呼函式可以呼叫 RemoveProp 函式。不過， RemoveProp 只能移除透過回呼函式參數傳遞至回呼函式的屬性。
回呼函式不應嘗試新增屬性。

備註

winuser.h 標頭會將 PROPENUMPROCEX 定義為別名，根據 UNICODE 前置處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

需求

Requirement	價值觀
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
Header	winuser.h （包括 Windows.h）