共用方式為

GetUserNameExA 函式 （secext.h）

  • 發行項

擷取與呼叫線程相關聯的使用者或其他安全性主體名稱。 您可以指定傳回名稱的格式。

如果線程模擬用戶端，GetUserNameEx 會傳回客戶端的名稱。

語法

BOOLEAN SEC_ENTRY GetUserNameExA(
  [in]      EXTENDED_NAME_FORMAT NameFormat,
  [out]     LPSTR                lpNameBuffer,
  [in, out] PULONG               nSize
);

參數

[in] NameFormat

名稱的格式。 此參數是來自 EXTENDED_NAME_FORMAT 列舉型別的值。 無法 NameUnknown。 如果用戶帳戶不在網域中，則只支援 NameSamCompatible。

[out] lpNameBuffer

緩衝區的指標，接收指定格式的名稱。 緩衝區必須包含終止 Null 字元的空間。

[in, out] nSize

在輸入時，此變數會在 TCHAR中指定 lpNameBuffer 緩衝區的大小。 如果函式成功，變數會收到複製到緩衝區 TCHAR 的數目，不包括終止的 Null 字元。

如果 lpNameBuffer 太小，則函式會失敗，GetLastError 傳回ERROR_MORE_DATA。 此參數會接收 Unicode 字元中所需的緩衝區大小（不論是否使用 Unicode），包括終止的 Null 字元。

傳回值

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

如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 可能的值包括下列專案。

傳回碼 描述
ERROR_MORE_DATA
 lpNameBuffer 緩衝區太小。 lpnSize 參數包含接收名稱所需的位元元數目。
ERROR_NO_SUCH_DOMAIN
 域控制器無法執行查閱
ERROR_NONE_MAPPED
 使用者名稱無法使用指定的格式。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 secext.h （include Security.h）
連結庫 Secur32.lib
DLL Secur32.dll

另請參閱

EXTENDED_NAME_FORMAT

LookupAccountName

系統資訊函式