IDynamicHWHandler::GetDynamicInfo method (shobjidl.h)

Called by the system to determine whether a particular handler will be shown before the AutoPlay dialog is displayed.

Syntax

HRESULT GetDynamicInfo(
  [in]  LPCWSTR pszDeviceID,
  [in]  DWORD   dwContentType,
  [out] LPWSTR  *ppszAction
);

Parameters

[in] pszDeviceID

Type: LPCWSTR

A pointer to a string that indicates the device path or drive root.

[in] dwContentType

Type: DWORD

The content type.

[out] ppszAction

Type: LPWSTR*

A pointer to the new action string, or NULL if the default action string is to be used.

Return value

Type: HRESULT

Returns S_OK if this handler is to be displayed, S_FALSE if it is to be hidden, or an error value otherwise.

Remarks

To register a dynamic handler, add a REG_SZ named "DynamicHWHandlerCLSID" and assign it the CLSID of your IDynamicHWHandler implementation.

Example:

HKLM
   Software
      Microsoft
         Windows
            CurrentVersion
               Explorer
                  AutoplayHandlers
                     Handlers
                        YourHandler
                           DynamicHWHandlerCLSID = [REG_SZ] {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	shobjidl.h