TranslateNameA 函式 (secext.h)

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

語法

BOOLEAN SEC_ENTRY TranslateNameA(
  [in]      LPCSTR               lpAccountName,
  [in]      EXTENDED_NAME_FORMAT AccountNameFormat,
  [in]      EXTENDED_NAME_FORMAT DesiredNameFormat,
  [out]     LPSTR                lpTranslatedName,
  [in, out] PULONG               nSize
);

參數

[in] lpAccountName

要翻譯的名稱。

[in] AccountNameFormat

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

[in] DesiredNameFormat

轉換名稱的格式。 此參數是 來自EXTENDED_NAME_FORMAT 列舉類型的值。 它不能是 NameUnknown。

[out] lpTranslatedName

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

[in, out] nSize

在輸入時，變數會指出 TCHAR 中 lpTranslatedName 緩衝區的大小。 在輸出時，變數會以 TCHAR 傳回傳回字串的大小，包括終止 的 Null 字元。

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

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

傳回值

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

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

備註

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

注意

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

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	secext.h (包含 Security.h)
程式庫	Secur32.lib
Dll	Secur32.dll
API 集合	ext-ms-win-secur32-translatename-l1-1-0 (Windows 8)

另請參閱

計算機名稱

DsC，Names

EXTENDED_NAME_FORMAT

系統資訊函式