共用方式為


SetUserGeoID 函式 (winnls.h)

[SetUserGeoID 可用於需求一節中指定的作業系統。 它在後續版本中可能會變更或無法使用。 請改用 SetUserGeoName

]

設定使用者的地理位置識別碼。 此識別碼應具有 地理位置資料表中所述的其中一個值。

語法

BOOL SetUserGeoID(
  [in] GEOID GeoId
);

參數

[in] GeoId

使用者的地理位置識別碼。

傳回值

如果成功或 FALSE,則傳回 TRUE 。否則傳回 TRUE

Windows XP、Windows Server 2003:此函式不提供延伸的錯誤資訊。 因此,應用程式不適合在此函式之後呼叫 GetLastError 。 如果應用程式確實呼叫 GetLastError,它可以傳回一些先前呼叫的函式所設定的值。

如果此函式不成功,應用程式可以呼叫 GetLastError,這可以傳回下列其中一個錯誤碼:

  • ERROR_ACCESS_DISABLED_BY_POLICY。 電腦或使用者的群組原則已禁止此作業。
  • ERROR_INTERNAL_ERROR。 函式中發生意外的錯誤。
  • ERROR_INVALID_PARAMETER。 任何參數值都無效。

備註

此函式會將特定使用者的地理位置寫入登錄,而不是特定應用程式。 此動作會影響使用者執行的其他應用程式行為。 因此,只有在使用者明確要求變更時,應用程式才應該呼叫此函式,但不應該只基於應用程式特定的原因呼叫。

SetUserGeoID 適用于設計來變更使用者設定的應用程式,例如 Windows 設定應用程式。 其他應用程式不應該呼叫此函式。

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 winnls.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

GetUserGeoID

國家語言支援

國家語言支援函式

SetUserGeoName

地理位置資料表