SetupPromptForDiskA 함수(setupapi.h)

아티클
03/13/2024

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

SetupPromptForDisk 함수는 사용자에게 디스크를 묻는 대화 상자를 표시합니다.

구문

WINSETUPAPI UINT SetupPromptForDiskA(
  [in]      HWND   hwndParent,
  [in]      PCSTR  DialogTitle,
  [in]      PCSTR  DiskName,
  [in]      PCSTR  PathToSource,
  [in]      PCSTR  FileSought,
  [in]      PCSTR  TagFile,
  [in]      DWORD  DiskPromptStyle,
  [in, out] PSTR   PathBuffer,
  [in]      DWORD  PathBufferSize,
  [in, out] PDWORD PathRequiredSize
);

매개 변수

[in] hwndParent

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

[in] DialogTitle

대화 상자 제목을 지정하는 null로 끝나는 문자열에 대한 선택적 포인터입니다. 이 매개 변수가 NULL이면 기본값인 ""%s--Files Needed"(지역화됨)가 사용됩니다. "%s"이(가) 부모 창에서 검색된 텍스트로 바뀝니다. 부모 창에서 텍스트를 검색하지 않으면 제목은 "필요한 파일"입니다.

[in] DiskName

삽입할 디스크의 이름을 지정하는 null로 끝나는 문자열에 대한 선택적 포인터입니다. 이 매개 변수가 NULL이면 기본 "(알 수 없음)"(지역화됨)이 사용됩니다.

[in] PathToSource

파일의 예상 위치(예: F:\x86)의 경로 부분을 지정하는 null로 끝나는 문자열에 대한 선택적 포인터입니다. 지정하지 않으면 SetupPromptForDisk 에서 가장 최근에 파일을 찾은 경로가 사용됩니다. 해당 목록이 비어 있으면 시스템 기본값이 사용됩니다.

[in] FileSought

필요한 파일의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다(파일 이름 부분만 해당). 사용자가 찾아보기 단추를 클릭하면 파일 이름이 표시됩니다. 이 루틴은 압축된 양식 이름을 사용하여 파일을 찾습니다. 따라서 cmd.exe 전달할 수 있으며 원본 미디어에 파일이 실제로 cmd.ex_ 존재할 염려하지 않을 수 있습니다.

[in] TagFile

특정 이동식 미디어 볼륨의 존재를 식별하는 태그 파일(파일 이름 부분만 해당)을 지정하는 null로 끝나는 문자열에 대한 선택적 포인터입니다. 현재 선택한 경로가 이동식 미디어에 파일을 배치하고 태그 파일을 지정한 경우 SetupPromptForDisk 는 드라이브의 루트에 있는 태그 파일을 찾은 후 계속할지 여부를 결정합니다.

예를 들어 PathToSource 가 A:\x86인 경우 tagfile은 disk1.tag이고 사용자가 B:\x86을 프롬프트 대화 상자의 편집 컨트롤에 입력하면 루틴은 B:\disk1.tag를 검색하여 계속할지 여부를 결정합니다. 태그 파일을 찾을 수 없는 경우 함수는 PathToSource를 사용하여 태그 파일을 찾습니다.

태그 파일을 지정하지 않으면 이동식 미디어가 이동식이 아닌 미디어와 마찬가지로 작동하며 계속하기 전에 FileSought 를 찾습니다.

[in] DiskPromptStyle

대화 상자의 동작을 지정합니다. 이 매개 변수는 다음 플래그의 조합일 수 있습니다.

IDF_CHECKFIRST

프롬프트 대화 상자를 표시하기 전에 파일/디스크를 확인하고 있는 경우 즉시 DPROMPT_SUCCESS 반환합니다.

IDF_NOBEEP

대화 상자가 처음 나타날 때 사용자의 주의를 끌기 위해 경고음이 발생하지 않도록 합니다.

IDF_NOBROWSE

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

IDF_NOCOMPRESSED

소스 파일의 압축된 버전에 대해 검사 않습니다.

IDF_NODETAILS

세부 정보를 표시하지 마세요.

IDF_NOFOREGROUND

대화 상자가 전경 창이 되지 않도록 합니다.

IDF_NOSKIP

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

IDF_OEMDISK

하드웨어 제조업체에서 제공하는 디스크를 묻는 메시지를 표시합니다.

IDF_WARNIFSKIP

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

[in, out] PathBuffer

반환 시 대화 상자를 통해 사용자가 지정한 위치의 경로(파일 이름 없음)를 수신하는 버퍼에 대한 선택적 포인터입니다. null로 끝나는 문자열을 사용해야 합니다. null로 끝나는 문자열은 대상 버퍼의 크기를 초과하면 안 됩니다. 함수를 한 번 호출하여 필요한 버퍼 크기를 얻고, 필요한 메모리를 할당한 다음, 함수를 두 번째로 호출하여 데이터를 검색할 수 있습니다. 이 기술을 사용하면 버퍼 크기가 부족하여 오류를 방지할 수 있습니다. 주의 섹션을 참조하십시오.

[in] PathBufferSize

PathBuffer가 가리키는 버퍼의 크기(문자)입니다. 적어도 MAX_PATH 길어야 합니다. 여기에는 null 종결자가 포함됩니다.

[in, out] PathRequiredSize

PathBuffer에 필요한 크기를 문자 단위로 받는 변수에 대한 선택적 포인터입니다. 여기에는 null 종결자가 포함됩니다.

반환 값

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

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

설명

이 함수가 NULL의 PathBuffer 및 PathBufferSize 0을 사용하여 호출되는 경우 함수는 지정된 데이터를 PathRequiredSize가 가리키는 변수에 보관하는 데 필요한 버퍼 크기를 배치합니다. 함수가 성공하면 반환 값이 NO_ERROR. 그렇지 않으면 반환 값은 반환 값 섹션에 설명된 값 중 하나입니다.

참고

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

요구 사항

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