ServiceBrokerExtensions.ReportMissingServiceAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Presents modeless UI to the user that explains why a feature is disabled or operating with reduced functionality.
public static System.Threading.Tasks.Task ReportMissingServiceAsync (this Microsoft.ServiceHub.Framework.IServiceBroker serviceBroker, string reducedFeatureId, string reducedFeature, Microsoft.ServiceHub.Framework.ServiceMoniker serviceMoniker, Guid toolWindowGuid = default, uint toolWindowInstanceId = 0, System.Threading.CancellationToken cancellationToken = default);static member ReportMissingServiceAsync : Microsoft.ServiceHub.Framework.IServiceBroker * string * string * Microsoft.ServiceHub.Framework.ServiceMoniker * Guid * uint32 * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ReportMissingServiceAsync (serviceBroker As IServiceBroker, reducedFeatureId As String, reducedFeature As String, serviceMoniker As ServiceMoniker, Optional toolWindowGuid As Guid = Nothing, Optional toolWindowInstanceId As UInteger = 0, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- serviceBroker
- IServiceBroker
The service broker that failed to produce the brokered service.
- reducedFeatureId
- String
A non-localized string that identifies the feature that is disabled or operating with reduced functionality. This string should be relatively static as it is used as a key to recognize and prevent redundant UI when the same feature reports failure multiple times. It may also be used in telemetry events to identify the impact of a missing service.
- reducedFeature
- String
A localized display name for the feature that is disabled or operating with reduced functionality. This string is inserted into the placeholder of a larger string in a singular grammatical context (e.g. "{Your feature} is broken"). While this value may use Title Case for the feature name, it should not contain punctuation.
- serviceMoniker
- ServiceMoniker
The moniker for the brokered service that is not available.
- toolWindowGuid
- Guid
The GUID for the tool window that hosts the feature's UI, if any. An infobar may be added to this tool window.
- toolWindowInstanceId
- UInt32
The ID of the multi-instance tool window specified by toolWindowGuid that the user was interacting with or otherwise should show the infobar, when applicable.
- cancellationToken
- CancellationToken
A cancellation token.
Returns
A task that represents the task of presenting UI to the user.
Remarks
This method is a stub for calling ReportReducedFunctionalityAsync(String, String, ServiceMoniker, Guid, UInt32, CancellationToken) on the ReducedFunctionalityReportingService service.