SetUserObjectInformationA 函式 (winuser.h)

發行項
03/15/2023

設定指定之視窗月臺或桌面物件的相關資訊。

語法

BOOL SetUserObjectInformationA(
  [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 的設定。否則，應用程式可能會有無法預期的行為，而且可能會更容易遭受安全性攻擊。

值

意義

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 的設定。否則，應用程式可能會有無法預期的行為，而且可能會更容易遭受安全性攻擊。

[in] pvInfo

緩衝區的指標，其中包含物件資訊或 BOOL。

[in] nLength

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

傳回值

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

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

備註

注意

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

規格需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll