SetupCopyErrorW 함수(setupapi.h)

아티클
03/01/2024

[이 함수는 요구 사항 섹션에 표시된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. SetupAPI는 더 이상 애플리케이션 설치에 사용되지 않아야 합니다. 대신 Windows Installer를 사용하여 애플리케이션 설치 관리자를 개발합니다. SetupAPI는 디바이스 드라이버를 설치하는 데 계속 사용됩니다.]

SetupCopyError 함수는 사용자에게 복사 파일 오류를 알리는 대화 상자를 생성합니다.

구문

WINSETUPAPI UINT SetupCopyErrorW(
  [in]      HWND   hwndParent,
  [in]      PCWSTR DialogTitle,
  [in]      PCWSTR DiskName,
  [in]      PCWSTR PathToSource,
  [in]      PCWSTR SourceFile,
  [in]      PCWSTR TargetPathFile,
  [out]     UINT   Win32ErrorCode,
  [in]      DWORD  Style,
  [in, out] PWSTR  PathBuffer,
  [in]      DWORD  PathBufferSize,
  [in, out] PDWORD PathRequiredSize
);

매개 변수

[in] hwndParent

이 대화 상자의 부모 창에 대한 핸들입니다.

[in] DialogTitle

대화 상자 제목을 지정하는 null로 끝나는 문자열에 대한 선택적 포인터입니다.

이 매개 변수는 NULL일 수 있습니다. 이 매개 변수가 NULL이면 "오류 복사"(시스템 언어로 지역화됨)의 기본 제목이 사용됩니다.

[in] DiskName

삽입할 디스크의 이름을 지정하는 null로 끝나는 문자열에 대한 선택적 포인터입니다.

이 매개 변수는 NULL일 수 있습니다. 이 매개 변수가 NULL이면 기본 이름 "(알 수 없음)"(시스템 언어로 지역화됨)이 사용됩니다.

[in] PathToSource

작업이 실패하는 원본 파일의 경로 구성 요소에 대한 포인터입니다(예: F:\x86).

null로 끝나는 문자열을 사용합니다.

[in] SourceFile

작업이 실패하는 파일의 파일 이름 부분을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

null로 끝나는 문자열을 사용합니다. 사용자가 세부 정보 또는 찾아보기 단추를 클릭하면 이 파일 이름이 표시됩니다. SetupCopyError 함수는 압축된 양식 이름을 사용하는 파일을 찾습니다. 따라서 cmd.exe 전달할 수 있으며 원본 미디어에 파일이 실제로 cmd.ex_ 존재할 염려가 없습니다.

[in] TargetPathFile

이름 바꾸기 및 복사 작업을 위해 대상 파일의 전체 경로를 지정하는 null로 끝나는 문자열에 대한 선택적 포인터입니다.

null로 끝나는 문자열을 사용합니다. 이 매개 변수는 NULL일 수 있습니다. TargetPathFile을 지정하지 않으면 "(알 수 없음)"(시스템 언어로 지역화됨)이 사용됩니다.

[out] Win32ErrorCode

오류가 발생하면 이 멤버는 시스템 오류 코드입니다.

오류가 발생하지 않으면 NO_ERROR.

[in] Style

대화 상자의 표시 서식 및 동작을 제어하는 플래그입니다.

이 매개 변수는 다음 플래그 중 하나일 수 있습니다.

IDF_NOBROWSE

찾아보기 옵션을 표시하지 마세요.

IDF_NOSKIP

파일 건너뛰기 옵션을 표시하지 마세요.

IDF_NODETAILS

세부 정보 옵션을 표시하지 마세요.

이 플래그를 설정하면 TargetPathFile 및 Win32ErrorCode 매개 변수를 생략할 수 있습니다.

IDF_NOCOMPRESSED

압축된 버전의 원본 파일은 검사 않습니다.

IDF_OEMDISK

작업 원본은 하드웨어 제조업체에서 제공하는 디스크입니다.

IDF_NOBEEP

대화 상자가 처음 나타날 때 사용자의 주의를 끌기 위해 경고음이 울리는 것을 방지합니다.

IDF_NOFOREGROUND

대화 상자가 포그라운드 창이 되지 않도록 합니다.

IDF_WARNIFSKIP

파일을 건너뛰면 설치에 영향을 줄 수 있음을 사용자에게 경고합니다.

[in, out] PathBuffer

이 함수가 사용자가 대화 상자에서 지정하는 위치의 경로(파일 이름 포함 안 됨)를 반환하는 변수에 대한 선택적 포인터입니다. null로 끝나는 문자열을 사용해야 합니다.

null로 끝나는 문자열은 대상 버퍼의 크기를 초과하면 안 됩니다. 버퍼 오류가 부족하지 않도록 하려면 PathBuffer 를 MAX_PATH 이상이어야 합니다. 자세한 내용은 이 항목의 ‘주의’ 섹션을 참조하세요.

[in] PathBufferSize

PathBuffer가 가리키는 버퍼의 크기(문자)입니다.

버퍼 크기는 null 종결자를 포함하여 최소 MAX_PATH 문자여야 합니다.

[in, out] PathRequiredSize

이 함수가 필요한 버퍼 크기를 null 종결자를 포함하여 문자 단위로 반환하는 변수에 대한 선택적 포인터입니다.

반환 값

함수는 다음 값 중 하나를 반환합니다.

확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수가 NULL의 PathBuffer 및 PathBufferSize 0으로 호출되는 경우 함수는 지정된 데이터를 PathRequiredSize가 가리키는 변수에 보관하는 데 필요한 버퍼 크기를 배치합니다.

함수가 성공하면 반환 값이 NO_ERROR. 그렇지 않으면 반환 값이 지정된 값 중 하나입니다.

버퍼 오류가 부족하지 않도록 하려면 ReturnBuffer 를 MAX_PATH 이상이어야 합니다.

참고

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	setupapi.h
라이브러리	Setupapi.lib
DLL	Setupapi.dll