SetupCopyErrorW 함수(setupapi.h)
[이 함수는 요구 사항 섹션에 표시된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 사용할 수 없습니다. 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
[in] DiskName
삽입할 디스크의 이름을 지정하는 null종료 문자열에 대한 선택적 포인터입니다.
이 매개 변수는 NULL
[in] PathToSource
작업이 실패하는 원본 파일의 경로 구성 요소(예: F:\x86)에 대한 포인터입니다.
null종료된 문자열을 사용합니다.
[in] SourceFile
작업이 실패하는 파일의 파일 이름 부분을 지정하는 null종료된 문자열에 대한 포인터입니다.
null종료된 문자열을 사용합니다. 이 파일 이름은 사용자가 세부 정보 클릭하거나 찾아보기 단추를 클릭하면 표시됩니다. SetupCopyError 함수는 압축된 양식 이름을 사용하는 파일을 찾습니다. 따라서 cmd.exe 전달할 수 있으며 원본 미디어에 cmd.ex_ 파일이 실제로 존재하는 것을 걱정할 필요가 없습니다.
[in] TargetPathFile
이름 바꾸기 및 복사 작업에 대한 대상 파일의 전체 경로를 지정하는 null종료된 문자열에 대한 선택적 포인터입니다.
null종료된 문자열을 사용합니다. 이 매개 변수는 NULL
[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
메모
setupapi.h 헤더는 SETUPCopyError를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
요구 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | setupapi.h |
라이브러리 | Setupapi.lib |
DLL | Setupapi.dll |