IShellLinkW::SetHotkey method (shobjidl_core.h)

Article
02/22/2024

Sets a keyboard shortcut (hot key) for a Shell link object.

Syntax

HRESULT SetHotkey(
  WORD wHotkey
);

Parameters

wHotkey

Type: WORD

The new keyboard shortcut. The virtual key code is in the low-order byte, and the modifier flags are in the high-order byte. The modifier flags can be a combination of the values specified in the description of the IShellLink::GetHotkey method.

Return value

Type: HRESULT

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

Remarks

Setting a keyboard shortcut allows the user to activate the object by pressing a particular combination of keys.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h
DLL	Shell32.dll (version 4.0 or later)

Share via