다음을 통해 공유

SoftwareUpdateMessageBox 함수(shlobj.h)

  • 아티클

애플리케이션이 업데이트되었음을 사용자에게 알리는 데 사용할 수 있는 표준 메시지 상자를 표시합니다.

구문

DWORD SoftwareUpdateMessageBox(
  [in, optional]  HWND           hWnd,
  [in]            PCWSTR         pszDistUnit,
                  DWORD          dwFlags,
  [out, optional] LPSOFTDISTINFO psdi
);

매개 변수

[in, optional] hWnd

형식: HWND

부모 창에 대한 핸들입니다.

[in] pszDistUnit

형식: PCWSTR

코드 배포 단위의 식별자를 포함하는 문자열 값입니다. ActiveX 컨트롤의 경우 pszDistUnit 은 일반적으로 GUID입니다.

dwFlags

형식:DWORD

예약되어 있습니다. 0으로 설정해야 합니다.

[out, optional] psdi

형식: LPSOFTDISTINFO

이 메서드가 성공적으로 반환될 때 업데이트 정보를 수신하는 SOFTDISTINFO 구조체에 대한 포인터입니다. cbSize 멤버를 로 초기화sizeof(SOFTDISTINFO)해야 합니다.

반환 값

형식:DWORD

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

반환 코드 설명
IDNO
 사용자가 대화 상자에서 업데이트 안 함 단추를 클릭했습니다.
IDYES
 사용자가 지금 업데이트 또는 업데이트정보 단추를 클릭했습니다. 애플리케이션은 psdi가 가리키는 구조체의 szHREF 멤버가 참조하는 HTML 페이지로 이동해야 합니다.
IDIGNORE
 보류 중인 소프트웨어 업데이트가 없습니다.
IDABORT
 오류가 발생했습니다.

설명

업데이트를 처리하는 기본 방법은 OSD(Open Software Description) 어휘를 사용하여 CDF(채널 정의 형식)를 작성하고 바로 가기 OSD를 인식하는 것입니다. 자세한 내용은 채널 정의 형식 설명서를 참조하세요.

SoftwareUpdateMessageBox 함수는 Shell 바로 가기 후크가 작동하지 않는 경우에 사용됩니다. 한 가지 예는 시작 메뉴에 설치되지 않은 애플리케이션입니다. 해당 애플리케이션이 자체 소프트웨어 업데이트 검사 수행해야 하는 경우 이 함수를 사용해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 shlobj.h
DLL Shdocvw.dll