애플리케이션이 업데이트되었음을 사용자에게 알리는 데 사용할 수 있는 표준 메시지 상자를 표시합니다.
Syntax
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
다음 값 중 하나를 반환합니다.
| 반환 코드 | Description |
|---|---|
|
사용자가 대화 상자에서 업데이트 안 함 단추를 클릭했습니다. |
|
사용자가 지금 업데이트 또는 업데이트정보 단추를 클릭했습니다. 애플리케이션은 psdi가 가리키는 구조체의 szHREF 멤버가 참조하는 HTML 페이지로 이동해야 합니다. |
|
보류 중인 소프트웨어 업데이트가 없습니다. |
|
오류가 발생했습니다. |
비고
업데이트를 처리하는 기본 방법은 OSD(Open Software Description) 어휘를 사용하여 CDF(채널 정의 형식)를 작성하고 바로 가기 OSD를 인식하는 것입니다. 자세한 내용은 채널 정의 형식 설명서를 참조하세요.
SoftwareUpdateMessageBox 함수는 셸 바로 가기 후크가 작동하지 않는 경우에 사용됩니다. 한 가지 예는 시작 메뉴에 설치되지 않은 애플리케이션입니다. 해당 애플리케이션이 자체 소프트웨어 업데이트 검사를 수행해야 하는 경우 이 함수를 사용해야 합니다.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 대상 플랫폼 | 윈도우즈 |
| Header | shlobj.h |
| Library | shdocvw.lib |
| DLL | Shdocvw.dll |