ITimerService::GetNamedTimer Method

---

Retrieves the named timer.

Syntax

HRESULT GetNamedTimer(
    REFGUID rguidName,
    ITimer **ppTimer
);

Parameters

rguidName

[in] Address of the name of the timer to retrieve.

ppTimer

[out] Address of the pointer to the new timer object.

Return Value

Returns one of the following values:
 

S_OK	The method was called successfully.
E_POINTER	A pointer is invalid.
E_INVALIDARG	One of the arguments is invalid.
E_OUTOFMEMORY	The system is out of memory.

Remarks

If the named timer exists, the reference counter is incremented, otherwise a new timer object is created.