SetPropA 函式 (winuser.h)

加入新的專案，或變更指定視窗之屬性清單中的現有專案。如果指定的字元字串不存在於清單中，此函式會將新專案新增至清單。新專案包含字串和句柄。否則，函式會以指定的句柄取代字串目前的句柄。

語法

BOOL SetPropA(
  [in]           HWND   hWnd,
  [in]           LPCSTR lpString,
  [in, optional] HANDLE hData
);

[in] hWnd

類型： HWND

視窗的句柄，其屬性清單會收到新專案。

[in] lpString

類型： LPCTSTR

以 Null 結束的字串或識別字串的 Atom。如果此參數是 Atom，它必須是先前呼叫 GlobalAddAtom 函式所建立的全域 Atom。 Atom 必須放在 lpString 的低順序字組中;高序字必須是零。

[in, optional] hData

類型： HANDLE

要複製到屬性清單之數據的句柄。數據句柄可以識別應用程式有用的任何值。

類型： BOOL

如果數據句柄和字串新增至屬性清單，則傳回值為非零值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

在視窗損毀 (也就是說，在從處理 WM_NCDESTROY 訊息) 傳回之前，應用程式必須移除它新增至屬性清單的所有專案。應用程式必須使用 RemoveProp 函式來移除專案。

SetProp 受限於使用者介面許可權隔離 (UIPI) 的限制。進程只能在屬於較小於或等於完整性層級之進程的視窗上呼叫此函式。當UIPI封鎖屬性變更時， GetLastError 會傳回 5。

如需範例，請參閱新增 Window 屬性。

注意

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

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-window-l1-1-4 (Windows 10 10.0.14393 版)