ClientServicingProxy.ReportClientStatus Method

Article
02/19/2014

Reports the status of software packages on a single client to the update server database.

Namespace: Microsoft.UpdateServices.ClientServicing
Assembly: Microsoft.UpdateServices.ClientServicing (in Microsoft.UpdateServices.ClientServicing.dll)

Usage

Syntax

'Declaration
Public Sub ReportClientStatus ( _
    clientId As String, _
    status As IEnumerable(Of PackageState), _
    cookie As MetadataStateCookie _
)

public void ReportClientStatus (
    string clientId,
    IEnumerable<PackageState> status,
    MetadataStateCookie cookie
)

public:
void ReportClientStatus (
    String^ clientId, 
    IEnumerable<PackageState>^ status, 
    MetadataStateCookie^ cookie
)

public void ReportClientStatus (
    String clientId, 
    IEnumerable<PackageState> status, 
    MetadataStateCookie cookie
)

public function ReportClientStatus (
    clientId : String, 
    status : IEnumerable<PackageState>, 
    cookie : MetadataStateCookie
)

Parameters

clientId
The GUID of the client for which package installation status is being reported.

status
A list of PackageState objects, one for each of the packages.

cookie
The MetadataStateCookie associated with the PackageMetadataSet against which the client synchronized. This cookie is used to get the time of the PackageMetadataSet.

Exceptions

Exception type	Condition
ArgumentNullException	clientId is null, or status is null.
ArgumentOutOfRangeException	clientId is too long.
ArgumentException	clientId is not a valid ID string.
InvalidCookieException	clientId is not valid for this update server..

Remarks

The client must report status of all packages it knows about when it makes this call. Any package that it knows and does not report will be assumed to be Not Applicable.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Target Platforms

Windows Server 2008, Windows Server 2003, Windows Server 2008 R2

Share via