Fungsi TranslateNameA (secext.h)

Mengonversi nama objek layanan direktori dari satu format ke format lainnya.

Sintaks

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

Parameter

[in] lpAccountName

Nama yang akan diterjemahkan.

[in] AccountNameFormat

Format nama yang akan diterjemahkan. Parameter ini adalah nilai dari jenis enumerasi EXTENDED_NAME_FORMAT .

[in] DesiredNameFormat

Format nama yang dikonversi. Parameter ini adalah nilai dari jenis enumerasi EXTENDED_NAME_FORMAT . Nama tidak boleh NameUnknown.

[out] lpTranslatedName

Penunjuk ke buffer yang menerima nama yang dikonversi.

[in, out] nSize

Pada input, variabel menunjukkan ukuran buffer lpTranslatedName , dalam TCHAR. Pada output, variabel mengembalikan ukuran string yang dikembalikan, dalam TCHAR, termasuk karakter null yang mengakhiri.

Jika lpTranslated adalah NULL dan nSize adalah 0, fungsi berhasil dan nSize menerima ukuran buffer yang diperlukan.

Jika buffer lpTranslatedName terlalu kecil untuk menahan nama yang dikonversi, fungsi gagal dan nSize menerima ukuran buffer yang diperlukan.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

TranslateName gagal jika tidak dapat mengikat ke Direktori Aktif pada pengendali domain.

Catatan

Header secext.h mendefinisikan TranslateName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	secext.h (termasuk Security.h)
Pustaka	Secur32.lib
DLL	Secur32.dll
Set API	ext-ms-win-secur32-translatename-l1-1-0 (diperkenalkan dalam Windows 8)

Lihat juga

Nama Komputer

DsCrackNames

EXTENDED_NAME_FORMAT

Fungsi Informasi Sistem