共用方式為

GetComputerObjectNameW 函式 （secext.h）

  • 發行項

擷取指定格式的本機計算機名稱。

語法

BOOLEAN SEC_ENTRY GetComputerObjectNameW(
  [in]      EXTENDED_NAME_FORMAT NameFormat,
  [out]     LPWSTR               lpNameBuffer,
  [in, out] PULONG               nSize
);

參數

[in] NameFormat

名稱的格式。 此參數是來自 EXTENDED_NAME_FORMAT 列舉型別的值。 它不可以是 NameUnknown。

[out] lpNameBuffer

緩衝區的指標，接收指定格式的名稱。

如果此參數 NULL，則函式會成功，且 lpnSize 參數會收到所需的大小，否則函式會因為ERROR_INSUFFICIENT_BUFFER而失敗，lpnSize 會收到所需的大小。 此行為取決於 NameFormat 和操作系統版本的值。

[in, out] nSize

在輸入時，在 TCHAR中，指定 lpNameBuffer 緩衝區的大小。 成功時，會收到複製到緩衝區的名稱大小。 如果 lpNameBuffer 緩衝區太小而無法儲存名稱，函式會失敗，lpnSize 收到所需的緩衝區大小。

傳回值

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

如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 secext.h （include Security.h）
連結庫 Secur32.lib
DLL Secur32.dll
API 集 ext-ms-win-secur32-translatename-l1-1-0 （在 Windows 8 中引進）

另請參閱

EXTENDED_NAME_FORMAT

GetComputerNameEx

系統資訊函式