SetupCopyErrorA 함수(setupapi.h)

아티클
11/20/2024

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

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

통사론

WINSETUPAPI UINT SetupCopyErrorA(
  [in]      HWND   hwndParent,
  [in]      PCSTR  DialogTitle,
  [in]      PCSTR  DiskName,
  [in]      PCSTR  PathToSource,
  [in]      PCSTR  SourceFile,
  [in]      PCSTR  TargetPathFile,
  [out]     UINT   Win32ErrorCode,
  [in]      DWORD  Style,
  [in, out] PSTR   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호출합니다.

발언

이 함수는 NULLPathBuffer 및 0의 PathBufferSize 사용하여 호출되는 경우 지정된 데이터를 PathRequiredSize가리키는 변수에 포함하는 데 필요한 버퍼 크기를 넣습니다.

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

버퍼 오류가 부족하지 않도록 하려면 ReturnBuffer 최소한 MAX_PATH 합니다.

메모

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

요구 사항

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