共用方式為


TranslateNameW 函式 (secext.h)

將目錄服務物件名稱從一種格式轉換成另一種格式。

語法

BOOLEAN SEC_ENTRY TranslateNameW(
  [in]      LPCWSTR              lpAccountName,
  [in]      EXTENDED_NAME_FORMAT AccountNameFormat,
  [in]      EXTENDED_NAME_FORMAT DesiredNameFormat,
  [out]     LPWSTR               lpTranslatedName,
  [in, out] PULONG               nSize
);

參數

[in] lpAccountName

要轉譯的名稱。

[in] AccountNameFormat

要轉譯的名稱格式。 此參數是來自 EXTENDED_NAME_FORMAT 列舉型別的值。

[in] DesiredNameFormat

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

[out] lpTranslatedName

接收已轉換名稱之緩衝區的指標。

[in, out] nSize

在輸入時,變數會指出 TCHARlpTranslatedName 緩衝區的大小。 在輸出中,變數會傳回傳回字串的大小,TCHARs,包括結束 null 字元。

如果 lpTranslated NULL,且 nSize 為 0,則函式會成功並 nSize 接收所需的緩衝區大小。

如果 lpTranslatedName 緩衝區太小而無法保存轉換的名稱,則函式會失敗,且 nSize 收到所需的緩衝區大小。

傳回值

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

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

言論

TranslateName 如果無法繫結至域控制器上的 Active Directory,就會失敗。

注意

secext.h 標頭會將 TranslateName 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 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 中引進)

另請參閱

電腦名稱

DsCrackNames

EXTENDED_NAME_FORMAT

系統資訊函式