다음을 통해 공유


AppExtensionCatalog.PackageStatusChanged 이벤트

정의

카탈로그의 확장 패키지가 제거, 업데이트 또는 설치될 때 발생하는 이벤트입니다.

// Register
event_token PackageStatusChanged(TypedEventHandler<AppExtensionCatalog, AppExtensionPackageStatusChangedEventArgs const&> const& handler) const;

// Revoke with event_token
void PackageStatusChanged(event_token const* cookie) const;

// Revoke with event_revoker
AppExtensionCatalog::PackageStatusChanged_revoker PackageStatusChanged(auto_revoke_t, TypedEventHandler<AppExtensionCatalog, AppExtensionPackageStatusChangedEventArgs const&> const& handler) const;
public event TypedEventHandler<AppExtensionCatalog,AppExtensionPackageStatusChangedEventArgs> PackageStatusChanged;
function onPackageStatusChanged(eventArgs) { /* Your code */ }
appExtensionCatalog.addEventListener("packagestatuschanged", onPackageStatusChanged);
appExtensionCatalog.removeEventListener("packagestatuschanged", onPackageStatusChanged);
- or -
appExtensionCatalog.onpackagestatuschanged = onPackageStatusChanged;
Public Custom Event PackageStatusChanged As TypedEventHandler(Of AppExtensionCatalog, AppExtensionPackageStatusChangedEventArgs) 

이벤트 유형

설명

이 이벤트는 패키지를 더 이상 사용할 수 없거나 유효하지 않거나 수정된 시기를 식별하는 데 도움이 됩니다. 이 이벤트를 처리하여 확장이 더 이상 유효하지 않을 수 있고 사용하지 않도록 설정해야 하는 시기를 결정합니다. 이 이벤트의 일반적인 용도는 확장을 제공하는 앱 패키지가 이동식 미디어에 설치되어 있는지 여부를 검색하는 것입니다. 사용자가 패키지가 포함된 미디어를 제거하면 해당 패키지에 대해 이 이벤트가 발생합니다.

PackageStatus 클래스는 가능한 패키지 상태 상태를 제공합니다. PackageStatus.VerifyIsOk를 사용하여 패키지가 양호한 상태인지 확인합니다. false를 반환하는 경우 PackageStatus.LicenseIssue 또는 PackageStatus.PackageOffline을 검사 이러한 상황에 대해 특별한 처리를 제공할 수 있습니다. 일반적으로 패키지 상태가 정상이 아니면 사용하지 않도록 설정해야 합니다. 확장을 로드하려고 할 때마다 PackageStatus.VerifyIsOk 를 호출하는 것이 좋습니다.

패키지에 문제가 있어 확장이 비활성화되거나 사용할 수 없다는 표시기를 확장 관리자 UI에 제공하려면 이 이벤트를 처리하는 것이 좋습니다.

사용자가 패키지를 업데이트할 수 있고 로드해도 괜찮을 수 있으므로 패키지에 문제가 있다고 판단한 경우에도 이 이벤트를 계속 처리합니다.

PackageUpdatingPackageUninstalling과 마찬가지로 이 이벤트는 상태 변경된 패키지만 전달합니다. 패키지를 로드한 AppExtensions와 일치시켜 상태 변경의 영향을 받는 확장을 결정해야 합니다.

적용 대상