PROPENUMPROCEXW 回調函式（winuser.h）

搭配 EnumPropsEx 函式使用的應用程式定義回呼函式。函式會從視窗的屬性清單中接收屬性專案。 PROPENUMPROCEX 類型會定義這個回呼函式的指標。 PropEnumProcEx 是應用程式定義函式名稱的佔位符。

語法

PROPENUMPROCEXW Propenumprocexw;

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

參數

unnamedParam1

類型：HWND

要列舉其屬性清單之視窗的句柄。此參數通常命名為 hWnd。

unnamedParam2

類型： LPWSTR

屬性清單專案的字串元件。這是透過呼叫 setProp 函式，將屬性新增至視窗屬性清單時所指定的字串，以及數據句柄。此參數通常命名為 lpString。

unnamedParam3

類型：HANDLE

數據的句柄。這個句柄是屬性清單項目的數據元件。此參數通常命名為 hData。

unnamedParam4

類型：ULONG_PTR

應用程式定義的數據。這是指定為呼叫 EnumPropsExlParam 參數的值。此參數通常命名為 dwData。

傳回值

類型：BOOL

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

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

言論

注意

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

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

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

注意

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

要求

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