다음을 통해 공유

SP_FILE_COPY_PARAMS_A 구조체(setupapi.h)

  • 아티클

SP_FILE_COPY_PARAMS 구조는 단일 파일 복사 작업을 설명합니다.

구문

typedef struct _SP_FILE_COPY_PARAMS_A {
  DWORD    cbSize;
  HSPFILEQ QueueHandle;
  PCSTR    SourceRootPath;
  PCSTR    SourcePath;
  PCSTR    SourceFilename;
  PCSTR    SourceDescription;
  PCSTR    SourceTagfile;
  PCSTR    TargetDirectory;
  PCSTR    TargetFilename;
  DWORD    CopyStyle;
  HINF     LayoutInf;
  PCSTR    SecurityDescriptor;
} SP_FILE_COPY_PARAMS_A, *PSP_FILE_COPY_PARAMS_A;

멤버

cbSize

구조체의 크기(바이트)입니다. 를 값 sizeof(SP_FILE_COPY_PARAMS)으로 설정합니다.

QueueHandle

SetupOpenFileQueue에서 반환한 설치 파일 큐에 대한 핸들입니다.

SourceRootPath

이 복사본의 원본 루트(예: A:)에 대한 선택적 포인터입니다.

SourcePath

파일을 찾을 수 있는 SourceRootPath 를 기준으로 하는 경로에 대한 선택적 포인터입니다.

SourceFilename

복사할 파일의 파일 이름 부분입니다.

SourceDescription

디스크 프롬프트 중에 사용할 원본 미디어에 대한 설명에 대한 선택적 포인터입니다.

SourceTagfile

SourceRootPath에 있는 태그 파일에 대한 선택적 포인터는 원본 미디어의 존재를 나타냅니다. 지정하지 않으면 파일 자체가 필요한 경우 태그 파일로 사용됩니다.

TargetDirectory

파일을 복사할 디렉터리입니다.

TargetFilename

대상 파일의 이름에 대한 선택적 포인터입니다. 지정하지 않으면 대상 파일의 이름이 원본 파일과 동일합니다.

CopyStyle

파일 복사 작업의 동작을 제어하는 플래그입니다. 이러한 플래그는 다음 값의 조합일 수 있습니다.

값 의미
SP_COPY_DELETESOURCE
 복사에 성공하면 원본 파일을 삭제합니다. 삭제에 실패하면 호출자에게 알림이 표시되지 않습니다.
SP_COPY_REPLACEONLY
 이렇게 하면 대상 경로에서 파일을 덮어쓰는 경우에만 파일을 복사합니다. 호출자에게 알림이 표시되지 않습니다.
SP_COPY_NEWER_OR_SAME
 복사되는 각 파일을 검사하여 해당 버전 리소스가 대상의 기존 복사본과 동일하거나 최신 버전이 아닌지 확인합니다.

버전 검사 중에 사용되는 파일 버전 정보는 버전 함수가 입력한 대로 VS_FIXEDFILEINFO 구조체의 dwFileVersionMS 및 dwFileVersionLS 멤버에 지정된 것입니다. 파일 중 하나에 버전 리소스가 없거나 버전 정보가 동일한 경우 원본 파일은 최신 버전으로 간주됩니다.

원본 파일이 버전 이상에서 같지 않고 CopyMsgHandler 가 지정된 경우 호출자에게 알림이 표시되고 복사본을 취소할 수 있습니다. CopyMsgHandler를 지정하지 않으면 파일이 복사되지 않습니다.
SP_COPY_NEWER_ONLY
 복사되는 각 파일을 검사하여 해당 버전 리소스가 대상의 기존 복사본보다 최신이 아님을 나타내는지 확인합니다. 원본 파일이 최신 버전이지만 버전이 기존 대상과 같지 않으면 파일이 복사됩니다.
SP_COPY_NOOVERWRITE
 대상 파일이 있는지 확인하고, 있는 경우 복사본을 거부할 수 있는 호출자에게 알립니다. CopyMsgHandler를 지정하지 않으면 파일을 덮어쓰지 않습니다.
SP_COPY_NODECOMP
 파일의 압축을 풀지 마세요. 이 플래그를 설정하면 대상 파일에 소스 이름의 압축되지 않은 형식(해당하는 경우)이 제공되지 않습니다. 예를 들어 f:\x86\cmd.ex_ \\install\temp에 복사하면 대상 파일이 \\install\temp\cmd.ex_. SP_COPY_NODECOMP 플래그를 지정하지 않으면 파일의 압축이 해제되고 대상이 \\install\temp\cmd.exe 호출됩니다. DestinationName의 파일 이름 부분(지정된 경우)이 제거되고 원본 파일의 파일 이름으로 대체됩니다. SP_COPY_NODECOMP 지정하면 언어 또는 버전 정보를 확인할 수 없습니다.
SP_COPY_LANGUAGEAWARE
 복사되는 각 파일을 검사하여 해당 언어가 대상에 이미 있는 기존 파일의 언어와 다른지 확인합니다. 이 경우 CopyMsgHandler 가 지정되면 호출자에게 알림이 표시되고 복사본을 취소할 수 있습니다. CopyMsgHandler를 지정하지 않으면 파일이 복사되지 않습니다.
SP_COPY_SOURCE_ABSOLUTE
 SourceFile 은 전체 원본 경로입니다. INF 파일의 SourceDisksNames 섹션에서 조회하지 마세요.
SP_COPY_SOURCEPATH_ABSOLUTE
 SourcePathRoot 는 원본 파일의 전체 경로 부분입니다. 파일이 있는 원본 미디어에 대한 INF 파일의 SourceDisksNames 섹션에 지정된 상대 원본을 무시합니다. SP_COPY_SOURCE_ABSOLUTE 지정된 경우 이 플래그는 무시됩니다.
SP_COPY_FORCE_IN_USE
 대상이 있는 경우 사용 중인 것처럼 동작하고 다음 시스템 다시 부팅에서 복사할 파일을 큐에 대기합니다.
SP_COPY_IN_USE_NEEDS_REBOOT
 복사 작업 중에 파일이 사용 중이면 시스템을 다시 부팅해야 한다고 사용자에게 경고합니다.
SP_COPY_NOSKIP
 사용자에게 파일을 건너뛸 수 있는 옵션을 제공하지 마세요.
SP_COPY_FORCE_NOOVERWRITE
 대상 파일이 있는지 확인하고, 있는 경우 파일을 덮어쓰지 않습니다. 호출자에게 알림이 표시되지 않습니다.
SP_COPY_FORCE_NEWER
 복사되는 각 파일을 검사하여 해당 버전 리소스(또는 이미지가 아닌 파일의 타임스탬프는)가 대상의 기존 복사본보다 최신이 아님을 나타내는지 확인합니다. 복사 중인 파일이 최신 파일이 아니면 파일이 복사되지 않습니다. 호출자에게 알림이 표시되지 않습니다.
SP_COPY_WARNIFSKIP
 사용자가 파일을 건너뛰려고 하면 파일을 건너뛰는 것이 설치에 영향을 줄 수 있음을 경고합니다. (시스템에 중요한 파일에 사용됩니다.)

LayoutInf

원본 정보를 가져오는 데 사용할 INF에 대한 핸들입니다.

SecurityDescriptor

파일에 적용할 ACL을 지정하는 선택적 보안 설명자 문자열입니다.

설명

참고

setupapi.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 SP_FILE_COPY_PARAMS 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 setupapi.h

참고 항목

개요

구조체