SPFILENOTIFY_NEEDNEWCABINET 메시지
SPFILENOTIFY_NEEDNEWCABINET 알림은 SetupIterateCabinet에 의해 전송되어 현재 파일이 다른 캐비닛에서 계속됨을 나타냅니다. 콜백 루틴은 SetupPromptForDisk를 호출하거나 사용자에게 다음 디스크를 삽입하라는 메시지를 표시하는 자체 대화 상자를 만들 수 있습니다.
SPFILENOTIFY_NEEDNEWCABINET
Param1 = (UINT) CabinetInfo;
Param2 = (UINT) NewPath;
매개 변수
-
Param1
-
추출할 캐비닛 및 파일에 대한 정보가 포함된 CABINET_INFO 구조체에 대한 포인터입니다.
-
Param2
-
콜백이 NO_ERROR 반환하는 경우 이 매개 변수는 null로 끝나는 문자열에 대한 포인터입니다. 문자열이 비어 있지 않으면 캐비닛에 대한 새 경로를 지정합니다.
반환 값
루틴은 다음 값 중 하나를 반환해야 합니다.
| 반환 코드 | 설명 |
|---|---|
|
오류가 발생하지 않았으며 캐비닛을 계속 처리합니다. |
|
지정된 형식의 오류가 발생했습니다.
SetupIterateCabinet 함수는 FALSE를 반환하고 지정된 오류 코드는 GetLastError 호출에 의해 반환됩니다. |
참고
기본 캐비닛 콜백 루틴은 없습니다. 따라서 SetupIterateCabinet에서 보낸 알림을 처리하기 위해 콜백 루틴을 제공해야 합니다.
설명
콜백 루틴이 NO_ERROR 반환하는 경우 SetupIterateCabinet 은 Param2가 가리키는 버퍼를 확인합니다. 버퍼가 비어 있지 않으면 새 원본 경로가 포함됩니다. 버퍼가 비어 있으면 원본 경로가 변경되지 않은 것으로 간주됩니다.
콜백 함수는 새 미디어를 삽입해야 하는 경우 SetupPromptForDisk 함수를 호출하여 반환하기 전에 캐비닛에 액세스할 수 있는지 확인해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 헤더 |
|