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 [僅限桌面應用程式]
目標平台 Windows
標頭 secext.h (包含 Security.h)
程式庫 Secur32.lib
Dll Secur32.dll

另請參閱

EXTENDED_NAME_FORMAT

LookupAccountName

系統資訊函式