다음을 통해 공유

SPFILENOTIFY_NEEDNEWCABINET 메시지

  • 아티클

SPFILENOTIFY_NEEDNEWCABINET 알림은 SetupIterateCabinet에 의해 전송되어 현재 파일이 다른 캐비닛에서 계속됨을 나타냅니다. 콜백 루틴은 SetupPromptForDisk를 호출하거나 사용자에게 다음 디스크를 삽입하라는 메시지를 표시하는 자체 대화 상자를 만들 수 있습니다.

SPFILENOTIFY_NEEDNEWCABINET
  Param1 = (UINT) CabinetInfo;
  Param2 = (UINT) NewPath;

매개 변수

Param1

추출할 캐비닛 및 파일에 대한 정보가 포함된 CABINET_INFO 구조체에 대한 포인터입니다.

Param2

콜백이 NO_ERROR 반환하는 경우 이 매개 변수는 null로 끝나는 문자열에 대한 포인터입니다. 문자열이 비어 있지 않으면 캐비닛에 대한 새 경로를 지정합니다.

반환 값

루틴은 다음 값 중 하나를 반환해야 합니다.

반환 코드 설명
NO_ERROR
 오류가 발생하지 않았으며 캐비닛을 계속 처리합니다.
ERROR_XXX
 지정된 형식의 오류가 발생했습니다. SetupIterateCabinet 함수는 FALSE를 반환하고 지정된 오류 코드는 GetLastError 호출에 의해 반환됩니다.

참고

기본 캐비닛 콜백 루틴은 없습니다. 따라서 SetupIterateCabinet에서 보낸 알림을 처리하기 위해 콜백 루틴을 제공해야 합니다.

설명

콜백 루틴이 NO_ERROR 반환하는 경우 SetupIterateCabinet 은 Param2가 가리키는 버퍼를 확인합니다. 버퍼가 비어 있지 않으면 새 원본 경로가 포함됩니다. 버퍼가 비어 있으면 원본 경로가 변경되지 않은 것으로 간주됩니다.

콜백 함수는 새 미디어를 삽입해야 하는 경우 SetupPromptForDisk 함수를 호출하여 반환하기 전에 캐비닛에 액세스할 수 있는지 확인해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003 [데스크톱 앱만 해당]
헤더
Setupapi.h

참고 항목

개요

알림

CABINET_INFO

SetupIterateCabinet