共用方式為


SetUserObjectInformationA 函式 (winuser.h)

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

語法

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

參數

[in] hObj

視窗月臺、桌面物件或目前進程虛擬控制碼的控制碼。 這個控制碼可由CreateWindowStation、OpenWindowStationCreateDesktopOpenDesktopGetCurrentProcess函式傳回。

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

[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

另請參閱

CreateDesktop

CreateWindowStation

GetUserObjectInformation

OpenDesktop

OpenWindowStation

USEROBJECTFLAGS

視窗月臺和桌面函式

視窗月臺