DragQueryFile(A)

DragQueryFile(A)

유저의 드러그·앤드·드롭 조작에 의해서 드롭 된 파일의 총수나 개개의 파일명을 취득합니다.

UINT DragQueryFileA(
    HDROP  hDrop,   // 내부 데이터 구조체의 핸들
    UINT   iFile,   // 파일 인덱스
    PTSTR  pszFile, // 파일명을 격납하는 버퍼의 주소
    UINT   cch      // pszFile 버퍼의 사이즈
);

SHELL32.DLL

인수

hDrop

드롭 된 파일을 나타내는 내부 데이터 구조체를 조작하기 위한 핸들을 지정합니다.이 값은 WM_DROPFILES 메세지의 wParam 파라미터에 해당합니다.

iFile

취득하는 파일의 인덱스를 지정합니다.이 인덱스는 0 (을)를 기준으로 한 것입니다.이 인수에 -1 (0xFFFFFFFF) (을)를 지정하면, 이 함수의 반환값으로서 드러그·앤드·드롭 된 파일의 수가 돌아갑니다.

pszFile

취득한 파일명을 격납하는 버퍼에의 포인터를 지정합니다.이 인수에 0 (NULL) (을)를 지정하면, 이 함수의 반환값으로서 필요한 문자열의 사이즈가 돌아갑니다.

cch

pszFile 파라미터로 지정한 버퍼의 사이즈를, 아르바이트수(Unicode 판의 경우는 문자수)로 지정합니다.

반환값

파일명을 취득하면 버퍼에 카피된 문자열의 아르바이트수(Unicode 판의 경우는 문자수)가 돌아갑니다.

iFile 파라미터로 나타나는 인덱스에 -1 (0xFFFFFFFF) (을)를 지정했을 경우, 드롭 된 파일의 수가 돌아갑니다.

iFile 파라미터로 나타나는 인덱스가 0 (으)로부터 전파일수까지의 사이의 값이며, 한편, pszFile 파라미터에 0 (NULL) (을)를 지정했을 경우, 파일명을 격납하는데 필요한 버퍼의 아르바이트수(Unicode 판의 경우는 문자수)가 돌아갑니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후