Fungsi TranslateNameW (secext.h)

Artikel
11/20/2024

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

Sintaksis

BOOLEAN SEC_ENTRY TranslateNameW(
  [in]      LPCWSTR              lpAccountName,
  [in]      EXTENDED_NAME_FORMAT AccountNameFormat,
  [in]      EXTENDED_NAME_FORMAT DesiredNameFormat,
  [out]     LPWSTR               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. Ini 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, dalamTCHAR , termasuk karakter null yang dihentikan.

Jika lpTranslated 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, panggil GetLastError.

Komentar

TranslateName gagal jika tidak dapat mengikat active Directory pada pengendali domain.

Nota

Header secext.h mendefinisikan TranslateName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

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

Lihat juga

Nama Komputer

DsCrackNames

EXTENDED_NAME_FORMAT

Fungsi Informasi Sistem

Bagikan melalui