GetUserDefaultGeoName 函式 (winnls.h)

擷取兩個字母的標準化組織 (ISO) 3166-1 程式代碼或數值 United The United Organization (UN) Series M,Number 49 (M.49) code for the default 地理位置。

語法

int GetUserDefaultGeoName(
  [out] LPWSTR geoName,
  [in]  int    geoNameCount
);

參數

[out] geoName

緩衝區的指標,此函式應針對用戶的預設地理位置,寫入以 Null 終止的雙字母 ISO 3166-1 或數值 UN M.49 程式代碼。

[in] geoNameCount

geoName 參數所指定的緩衝區大小。 如果此值為零,函式只會傳回函式會複製到輸出緩衝區的字元數,但不會將用戶的預設地理位置名稱寫入緩衝區。

傳回值

如果 geoNameCount 參數的值是零,則函式會複製到輸出緩衝區的字元數。 否則,函式複製到 geoName 參數所指定之緩衝區的字元數。

零表示函式失敗。 若要取得擴充錯誤資訊,請呼叫 GetLastError,以傳回下列其中一個錯誤碼:

傳回碼 Description
ERROR_INVALID_PARAMETER
參數值無效。
ERROR_BADDB
函式無法從登錄讀取資訊。
ERROR_INSUFFICIENT_BUFFER
geoName 參數指定的緩衝區對字串而言太小。

備註

如需兩個字母 ISO 3166-1 代碼的相關信息,請參閱 國家/地區代碼 - ISO 3166。 如需數值 UN M.49 代碼的相關信息,請參閱 標準國家或地區代碼,以用於統計用途 (M49)

規格需求

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

另請參閱

GetUserGeoID

國家語言支援

國家語言支援函式

SetUserGeoName