Struktur SHNAMEMAPPINGA (shellapi.h)

Berisi nama jalur lama dan baru untuk setiap file yang dipindahkan, disalin, atau diganti namanya dengan fungsi SHFileOperation.

Sintaksis

typedef struct _SHNAMEMAPPINGA {
  LPSTR pszOldPath;
  LPSTR pszNewPath;
  int   cchOldPath;
  int   cchNewPath;
} SHNAMEMAPPINGA, *LPSHNAMEMAPPINGA;

Anggota

pszOldPath

Jenis: LPTSTR

Alamat buffer karakter yang berisi nama jalur lama.

pszNewPath

Jenis: LPTSTR

Alamat buffer karakter yang berisi nama jalur baru.

cchOldPath

Jenis: int

Jumlah karakter dalam pszOldPath.

cchNewPath

Jenis: int

Jumlah karakter dalam pszNewPath.

Komentar

Ada dua versi struktur ini, versi ANSI (SHFILEOPSTRUCTA) dan versi Unicode (SHFILEOPSTRUCTW). Versi Unicode identik dengan versi ANSI, kecuali bahwa string karakter lebar (LPCWSTR) digunakan sebagai pengganti string karakter ANSI (LPCSTR). Pada Windows 98 dan yang lebih lama, hanya versi ANSI yang didukung. Pada Microsoft Windows NT 4.0 dan yang lebih baru, versi ANSI dan Unicode dari struktur ini didukung. SHNAMEMAPPINGA dan SHNAMEMAPPINGW tidak boleh digunakan secara langsung; struktur yang sesuai didefinisikan ulang sebagai SHNAMEMAPPING oleh precompiler tergantung pada apakah aplikasi dikompilasi untuk ANSI atau Unicode.

Nota

Header shellapi.h mendefinisikan SHNAMEMAPPING 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 XP [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	shellapi.h

Lihat juga

SHFILEOPSTRUCT