RemovePropA 函式 (winuser.h)
從指定視窗的屬性清單中移除專案。 指定的字元字串會識別要移除的專案。
語法
HANDLE RemovePropA(
[in] HWND hWnd,
[in] LPCSTR lpString
);
參數
[in] hWnd
類型:HWND
要變更其屬性清單之視窗的句柄。
[in] lpString
類型:LPCTSTR
以 Null 結尾的字元字串或識別字串的 Atom。 如果此參數是 atom,則必須使用 globalAddAtom 函式
傳回值
類型:HANDLE
傳回值會識別指定的數據。 如果指定屬性清單中找不到資料,則傳回值會 NULL。
言論
傳回值是傳遞至 SetProp
RemoveProp 函式會傳回與字元串相關聯的數據句柄,讓應用程式可以釋放與句柄相關聯的數據。
從 Windows Vista 開始,RemoveProp 受限於使用者介面許可權隔離 (UIPI) 的限制。 進程只能在屬於較小或等於完整性層級之進程的視窗上呼叫此函式。 當 UIPI 封鎖屬性變更時,GetLastError 會傳回 5。
例子
如需範例,請參閱 刪除 Window 屬性。
注意
winuser.h 標頭會將 RemoveProp 定義為別名,根據 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-0 (在 Windows 8 中引進) |
另請參閱
概念
參考