IUserNotification Interface

IID_IUserNotification

{BA9711BA-5893-4787-A7E1-41277151550B}

The IUserNotification interface provides methods that display ToolTip information to the user in a balloon that will appear in the status area of the taskbar.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IUserNotification Methods

Description

SetBalloonInfo

Sets the information to be displayed in a balloon-style ToolTip.

SetBalloonRetry

Specifies the conditions for trying to display user information again.

SetIconInfo

Sets the icon associated with specific user information.

Show

Displays the user information balloon-style ToolTip.

PlaySound

Plays a sound file.

SetBalloonInfo

FUNCTION IUserNotification_SetBalloonInfo ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL pszTitle AS STRING _

, BYVAL pszText AS STRING _

, BYVAL dwInfoFlags AS DWORD _

  ) AS LONG
 

  LOCAL HRESULT AS LONG

  pszTitle = UCODE$(pszTitle) & $NUL
  pszText = UCODE$(pszText) & $NUL
  CALL DWORD @@pthis[3] USING IUserNotification_SetBalloonInfo (pthis, pszTitle, pszText, dwInfoFlags) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION

SetBalloonRetry

FUNCTION IUserNotification_SetBalloonRetry ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL dwShowTime AS DWORD _

, BYVAL dwInterval AS DWORD _

, BYVAL cRetryCount AS DWORD _

  ) AS LONG
 

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[4] USING IUserNotification_SetBalloonRetry (pthis, dwShowTime, dwInterval, cRetryCount) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION

SetIconInfo

FUNCTION IUserNotification_SetIconInfo ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL hIcon AS DWORD _

, BYVAL pszToolTip AS STRING _

  ) AS LONG
 

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[5] USING IUserNotification_SetIconInfo (pthis, hIcon, pszToolTip) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION

Show

FUNCTION IUserNotification_Show ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL pqc AS DWORD _

, BYVAL dwContinuePollInterval AS STRING _

  ) AS LONG
 

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[6] USING IUserNotification_Show (pthis, pqc, dwContinuePollInterval) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION

PlaySound

FUNCTION IUserNotification_PlaySound ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL pszSoundName AS STRING _

  ) AS LONG
 

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[7] USING IUserNotification_PlaySound (pthis, pszSoundName) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION