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 이상. 설명자가 유니코드입니다.

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 또는 유니코드 버전을 자동으로 선택하는 별칭으로 FILEDESCRIPTOR를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	shlobj_core.h