SetUserGeoID 函式 (winnls.h)

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

]

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

語法

BOOL SetUserGeoID(
  [in] GEOID GeoId
);

[in] GeoId

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

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

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

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

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

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