IsFutureWindowAvailable Method in Class CCM_ServiceWindowManager
The IsFutureWindowAvailable
WMI class method, in Configuration Manager, determines whether a service window of a specified type and the given duration is going to be available.
The following syntax is simplified from Managed Object Format (MOF) code and defines the method.
Syntax
uint32 IsFutureWindowAvailable(
[IN] UInt32 ServiceWindowType,
[IN] Boolean FallbackToAllProgramsWindow,
[IN] UInt32 MaxRuntime,
[OUT] Boolean WillProgramRunInFuture
);
Parameters
ServiceWindowType
Data type: UInt32
Qualifiers: [in]
Type of service window. The following table lists the possible values.
Value | Service Window Type | Description |
---|---|---|
1 | ALLPROGRAM_SERVICEWINDOW | All Programs Service Window |
2 | PROGRAM_SERVICEWINDOW | Program Service Window |
3 | REBOOTREQUIRED_SERVICEWINDOW | Reboot Required Service Window |
4 | SOFTWAREUPDATE_SERVICEWINDOW | Software Update Service Window |
5 | OSD_SERVICEWINDOW | OSD Service Window |
6 | USER_DEFINED_SERVICE_WINDOW | Corresponds to non-working hours |
FallbackToAllProgramsWindow
Data type: Boolean
Qualifiers: [in]
true
if the generic All programs window service window is to be used when a window specified in ServiceWindowType
is not available; otherwise, false
.
MaxRuntime
Data type: UInt32
Qualifiers: [in]
Maximum run time, in seconds, that a software update installation has to complete before the installation is no longer monitored by Configuration Manager. This setting is also used to determine whether there is enough time to install the update before the end of a maintenance window. The default setting is 60 minutes (3600 seconds) for service packs and 5 minutes (300 seconds) for all other software update types.
Important
Make sure that the maximum run time value is not set for more time than the configured maintenance window or the software update installation will not initiate.
WillProgramRunInFuture
Data type: Boolean
Qualifiers: [out]
true
if the specified service window is going to be available; otherwise, false
.
Return Values
A UInt32
data type that is 0 to indicate success or nonzero to indicate failure.
For information about handling returned errors, see About Configuration Manager Errors.
Remarks
Requirements
Runtime Requirements
For more information, see Configuration Manager Client Runtime Requirements.
Development Requirements
For more information, see Configuration Manager Client Development Requirements.