FILEDESCRIPTORW 構造体 (shlobj_core.h)

  • [アーティクル]

Microsoft ActiveX の ドラッグ アンド ドロップ 操作中にクリップボードによってコピーされるファイルのプロパティについて説明します。

構文

typedef struct _FILEDESCRIPTORW {
  DWORD    dwFlags;
  CLSID    clsid;
  SIZEL    sizel;
  POINTL   pointl;
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  WCHAR    cFileName[MAX_PATH];
} FILEDESCRIPTORW, *LPFILEDESCRIPTORW;

メンバー

dwFlags

型: DWORD

有効なデータを含む他の構造体メンバーのどれを示すフラグの配列。 このメンバーには、次の値の組み合わせを指定できます。

FD_CLSID (0x00000001)

0x00000001。 clsid メンバーは有効です。

FD_SIZEPOINT (0x00000002)

0x00000002。 sizel メンバーと pointl メンバーは有効です。

FD_ATTRIBUTES (0x00000004)

0x00000004。 dwFileAttributes メンバーは有効です。

FD_CREATETIME (0x00000008)

0x00000008。 ftCreationTime メンバーは有効です。

FD_ACCESSTIME (0x00000010)

0x00000010。 ftLastAccessTime メンバーは有効です。

FD_WRITESTIME (0x00000020)

0x00000020。 ftLastWriteTime メンバーは有効です。

FD_FILESIZE (0x00000040)

0x00000040。 nFileSizeHigh メンバーと nFileSizeLow メンバーは有効です。

FD_PROGRESSUI (0x00004000)

0x00004000。 進行状況インジケーターは、ドラッグ アンド ドロップ操作と共に表示されます。

FD_LINKUI (0x00008000)

0x00008000。 操作をショートカットとして扱います。

FD_UNICODE ((int)0x80000000)

(int)0x80000000。 Windows Vista 以降。 記述子は Unicode です。

clsid

型: CLSID

ファイルの種類の識別子。

sizel

種類: SIZEL

ファイル アイコンの幅と高さ。

pointl

種類: POINTL

ファイル オブジェクトの画面座標。

dwFileAttributes

型: DWORD

ファイル属性フラグ。 これは、 GetFileAttributes で説明されているFILE_ATTRIBUTE_値の組み合わせになります。

ftCreationTime

種類: FILETIME

ファイルの作成時刻を含む FILETIME 構造体。

ftLastAccessTime

種類: FILETIME

ファイルが最後にアクセスされた時刻を含む FILETIME 構造体。

ftLastWriteTime

種類: FILETIME

最後の書き込み操作の時刻を含む FILETIME 構造体。

nFileSizeHigh

型: DWORD

ファイル サイズの上位 DWORD (バイト単位)。

nFileSizeLow

型: DWORD

ファイル サイズの下位 DWORD (バイト単位)。

cFileName[MAX_PATH]

種類: TCHAR[MAX_PATH]

ファイルの名前を含む null で終わる文字列。

注釈

この構造体に対応する CFSTR_FILECONTENTS 形式にグローバル メモリ オブジェクトとしてファイルが含まれている場合、 nFileSizeHigh と nFileSizeLow は、関連付けられているメモリ ブロックのサイズを指定します。 設定されている場合は、ユーザー インターフェイスを表示する必要がある場合にも使用できます。 たとえば、ファイルが上書きされようとしている場合は、通常、この構造体の情報を使用して、ファイルのサイズ、データ、名前を含むダイアログ ボックスを表示します。

長さ 0 のファイルを作成するには、dwFlags で FD_FILESIZE フラグを設定し、nFileSizeHigh と nFileSizeLow を 0 に設定します。 CFSTR_FILECONTENTS形式は、ファイルをストリームまたはグローバル メモリ オブジェクト (TYMED_ISTREAM または TYMED_HGLOBAL) として表す必要があります。

注意

shlobj_core.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして FILEDESCRIPTOR を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header shlobj_core.h