IWMSServerLimits::get_DiagnosticEvents

The get_DiagnosticEvents method retrieves the maximum number of IWMSDiagnosticEvent objects that a specific IWMSDiagnosticEvents collection can contain.

HRESULT get_DiagnosticEvents(
  long*  pVal
);

Arguments

pVal	[out] Pointer to a long containing the maximum number of diagnostic events.

Return Value

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code	Number	Description
E_POINTER	0x80004003	Indicates that pVal is a NULL pointer argument.

Remarks

The default number of objects that this collection can contain is 200. Valid values are 100 to 2000.

After the specified limit is reached, the oldest object, as determined by its Time property, will be replaced when a new diagnostic event occurs.

Example

#include <windows.h>
#include "wmsserver.h"

// Declare variables and interfaces.
IWMSServer          *pServer;
IWMSServerLimits    *pLimits;

HRESULT         hr;
long            lValue;

// Initialize the COM library and retrieve a pointer
// to an IWMSServer interface.
hr = CoInitialize(NULL);
hr = CoCreateInstance(CLSID_WMSServer,
                      NULL,
                      CLSCTX_ALL,
                      IID_IWMSServer,
                      (void **)&pServer);
if (FAILED(hr)) goto EXIT;

// Retrieve a pointer to the IWMSServerLimits
// interface for the server.
hr = pServer->get_Limits(&pLimits);
if (FAILED(hr)) goto EXIT;

// Retrieve the maximum number of diagnostic events
// that the server keeps track of at once.
hr = pLimits->get_DiagnosticEvents(&lValue);
if (FAILED(hr)) goto EXIT;

EXIT:
    // TODO: Release temporary COM objects and uninitialize COM.

Requirements

Header: wmsserver.h.

Library: WMSServerTypeLib.dll.

Platform: Windows Server 2003 family, Windows Server 2008 family.

See Also

Reference

IWMSDiagnosticEvents Interface

IWMSServerLimits Interface