Struktur FILEDESCRIPTORA (shlobj_core.h)

Menjelaskan properti file yang sedang disalin melalui clipboard selama operasi seret dan letakkan Microsoft ActiveX.

Sintaks

typedef struct _FILEDESCRIPTORA {
  DWORD    dwFlags;
  CLSID    clsid;
  SIZEL    sizel;
  POINTL   pointl;
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  CHAR     cFileName[MAX_PATH];
} FILEDESCRIPTORA, *LPFILEDESCRIPTORA;

Anggota

dwFlags

Jenis: DWORD

Array bendera yang menunjukkan anggota struktur lain mana yang berisi data yang valid. Anggota ini bisa menjadi kombinasi dari nilai berikut.

FD_CLSID (0x00000001)

0x00000001. Anggota clsid valid.

FD_SIZEPOINT (0x00000002)

0x00000002. Anggota sizel dan pointl valid.

FD_ATTRIBUTES (0x00000004)

0x00000004. Anggota dwFileAttributes valid.

FD_CREATETIME (0x00000008)

0x00000008. Anggota ftCreationTime valid.

FD_ACCESSTIME (0x00000010)

0x00000010. Anggota ftLastAccessTime valid.

FD_WRITESTIME (0x00000020)

0x00000020. Anggota ftLastWriteTime valid.

FD_FILESIZE (0x00000040)

0x00000040. Anggota nFileSizeHigh dan nFileSizeLow valid.

FD_PROGRESSUI (0x00004000)

0x00004000. Indikator kemajuan ditampilkan dengan operasi seret dan letakkan.

FD_LINKUI (0x00008000)

0x00008000. Perlakukan operasi sebagai pintasan.

FD_UNICODE ((int)0x80000000)

(int)0x80000000. Windows Vista dan yang lebih baru. Deskriptornya adalah Unicode.

clsid

Jenis: CLSID

Pengidentifikasi jenis file.

sizel

Jenis: SIZEL

Lebar dan tinggi ikon file.

pointl

Jenis: POINTL

Koordinat layar objek file.

dwFileAttributes

Jenis: DWORD

Bendera atribut file. Ini akan menjadi kombinasi dari nilai FILE_ATTRIBUTE_ yang dijelaskan dalam GetFileAttributes.

ftCreationTime

Jenis: FILETIME

Struktur FILETIME yang berisi waktu pembuatan file.

ftLastAccessTime

Jenis: FILETIME

Struktur FILETIME yang berisi waktu file terakhir diakses.

ftLastWriteTime

Jenis: FILETIME

Struktur FILETIME yang berisi waktu operasi tulis terakhir.

nFileSizeHigh

Jenis: DWORD

DWORD urutan tinggi dari ukuran file, dalam byte.

nFileSizeLow

Jenis: DWORD

DWORD berurutan rendah dari ukuran file, dalam byte.

cFileName[MAX_PATH]

Jenis: TCHAR[MAX_PATH]

String yang dihentikan null yang berisi nama file.

Keterangan

Jika format CFSTR_FILECONTENTS yang sesuai dengan struktur ini berisi file sebagai objek memori global, nFileSizeHigh dan nFileSizeLow menentukan ukuran blok memori terkait. Jika diatur, mereka juga dapat digunakan jika antarmuka pengguna perlu ditampilkan. Misalnya, jika file akan ditimpa, Anda biasanya akan menggunakan informasi dari struktur ini untuk menampilkan kotak dialog yang berisi ukuran, data, dan nama file.

Untuk membuat file panjang nol, atur bendera FD_FILESIZE di dwFlags, dan atur nFileSizeHigh dan nFileSizeLow ke nol. Format CFSTR_FILECONTENTS harus mewakili file sebagai objek aliran atau memori global (TYMED_ISTREAM atau TYMED_HGLOBAL).

Catatan

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