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
在輸入時,變數會指出 TCHAR中 lpTranslatedName 緩衝區的大小。 在輸出中,變數會傳回傳回字串的大小,TCHARs,包括結束 null 字元。
如果
如果 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 中引進) |