CreateHardwareEventMoniker function

[This function is available through Windows XP with Service Pack 2 (SP2) and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows.]

Creates a moniker representing a hardware component and its associated event handler. AutoPlay uses this function to allow applications to use AutoPlay events.

Syntax

HRESULT CreateHardwareEventMoniker(
  _In_  REFCLSID clsid,
  _In_  LPCTSTR  pszEventHandler,
  _Out_ IMoniker **ppmoniker
);

Parameters

clsid [in]

Type: REFCLSID

The ID of the class to which the moniker binds.

pszEventHandler [in]

Type: LPCTSTR

The name of the event handler.

ppmoniker [out]

Type: IMoniker**

The address of a pointer variable that receives the IMoniker interface pointer.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Use CreateHardwareEventMoniker when registering running applications so that those applications have access to AutoPlay events. To use AutoPlay events in running applications, you must first create a new component that implements the IHWEventHandler interface. Initialize this interface with the InitCmdLine value from the particular handler's entry under the Handlers key, because AutoPlay does not call the Initialize method.

You should call CreateHardwareEventMoniker to get a moniker that represents your component and its event handler. Then, use the value returned in the ppmoniker parameter to register your component in the running object table (ROT) as shown in the example.

Note that CreateHardwareEventMoniker is not defined in a header file. To use it in your code, you must obtain a handle to the Shsvcs.dll file through a call to LoadLibrary. You then use that handle in a call to GetProcAddress to obtain an instance of the CreateHardwareEventMoniker function.

The call to IRunningObjectTable::Register requires that you enter the following AppID information in the registry.

HKEY_CLASSES_ROOT
   AppID
      MyApp.exe
         (Default) = MyApplication
         AppID [REG_SZ] = {Your GUID here}

HKEY_CLASSES_ROOT
   AppID
      {The same GUID here}
         (Default) = MyApplication
         RunAs = Interactive User

Requirements