SetUserObjectInformationW 函式（winuser.h）

設定指定之視窗月臺或桌面對象的相關信息。

語法

BOOL SetUserObjectInformationW(
  [in] HANDLE hObj,
  [in] int    nIndex,
  [in] PVOID  pvInfo,
  [in] DWORD  nLength
);

[in] hObj

視窗月臺、桌面物件或目前進程虛擬句柄的句柄。此句柄可由 CreateWindowStation、OpenWindowStation、CreateDesktop、OpenDesktop 或 GetCurrentProcess 函式傳回。

[in] nIndex

要設定的物件資訊。此參數可以是下列值。

價值	意義
UOI_FLAGS 1	設定物件的句柄旗標。 pvInfo 參數必須指向 USEROBJECTFLAGS 結構。
UOI_TIMERPROC_EXCEPTION_SUPPRESSION 7	在呼叫 timerProc 時，設定例外狀況處理行為。 hObj 必須是由 getCurrentProcess 函式傳回的進程句柄。 pvInfo 參數必須指向 BOOL。如果為 TRUE，Windows 會將其呼叫封入 TimerProc，並包含取用和捨棄所有例外狀況的例外狀況處理程式。這是自 Windows 2000 以來的預設行為，儘管這可能會在未來的 Windows 版本中變更。如果 pvInfo 指向 FALSE，Windows 將不會將呼叫封入例外狀況處理程式 TimerProc。建議使用 FALSE 的設定。否則，應用程式的行為可能會無法預期，而且可能更容易遭受安全性攻擊。

價值

意義

設定物件的句柄旗標。 pvInfo 參數必須指向 USEROBJECTFLAGS 結構。

在呼叫 timerProc 時，設定例外狀況處理行為。 hObj 必須是由 getCurrentProcess 函式傳回的進程句柄。

pvInfo 參數必須指向 BOOL。如果為 TRUE，Windows 會將其呼叫封入 TimerProc，並包含取用和捨棄所有例外狀況的例外狀況處理程式。這是自 Windows 2000 以來的預設行為，儘管這可能會在未來的 Windows 版本中變更。

如果 pvInfo 指向 FALSE，Windows 將不會將呼叫封入例外狀況處理程式 TimerProc。建議使用 FALSE 的設定。否則，應用程式的行為可能會無法預期，而且可能更容易遭受安全性攻擊。

[in] pvInfo

包含物件資訊或BOOL之緩衝區的指標。

[in] nLength

pvInfo 所指向之緩衝區中的資訊大小，以位元組為單位。

如果函式成功，則傳回值為非零值。

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

注意

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

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