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。 原子必須放在低序字組，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 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | winuser.h （包括 Windows.h） |
| 連結庫 | User32.lib |
| DLL | User32.dll |
| API 集 | ext-ms-win-ntuser-window-l1-1-4 （在 Windows 10 版本 10.0.14393 中引進） |
另請參閱
概念
參考