funzione CDefFolderMenu_Create2 (shlobj_core.h)

Crea un menu di scelta rapida per un gruppo selezionato di oggetti cartelle file.

Sintassi

SHSTDAPI CDefFolderMenu_Create2(
  [in, optional] PCIDLIST_ABSOLUTE     pidlFolder,
  [in, optional] HWND                  hwnd,
                 UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
  [in, optional] IShellFolder          *psf,
  [in, optional] LPFNDFMCALLBACK       pfn,
                 UINT                  nKeys,
  [in, optional] const HKEY            *ahkeys,
  [out]          IContextMenu          **ppcm
);

Parametri

[in, optional] pidlFolder

Tipo: PCIDLIST_ABSOLUTE

Struttura ITEMIDLIST per la cartella padre. Questo valore può essere NULL.

[in, optional] hwnd

Tipo: HWND

Handle alla finestra padre. Questo valore può essere NULL.

cidl

Tipo: UINT

Numero di strutture ITEMIDLIST nella matrice a cui punta apidl.

[in, optional] apidl

Tipo: PCUITEMID_CHILD_ARRAY*

Puntatore a una matrice di strutture ITEMIDLIST , una per ogni elemento selezionato.

[in, optional] psf

Tipo: IShellFolder*

Puntatore all'interfaccia IShellFolder della cartella padre. Questo IShellFolder deve supportare l'interfaccia IDataObject . In caso contrario, CDefFolderMenu_Create2 ha esito negativo e restituisce E_NOINTERFACE. Questo valore può essere NULL.

[in, optional] pfn

Tipo: LPFNDFMCALLBACK

Oggetto callback LPFNDFMCALLBACK . Questo valore può essere NULL se l'oggetto callback non è necessario.

nKeys

Tipo: UINT

Numero di chiavi del Registro di sistema nella matrice puntate da ahkeys.

[in, optional] ahkeys

Tipo: const HKEY*

Puntatore a una matrice di chiavi del Registro di sistema che specificano i gestori di menu di scelta rapida usati con le voci del menu. Per altre informazioni sui gestori di menu di scelta rapida, vedere Creazione di gestori di menu di scelta rapida. Questa matrice può contenere un massimo di 16 chiavi del Registro di sistema.

[out] ppcm

Tipo: IContextMenu**

L'indirizzo di un puntatore dell'interfaccia IContextMenu che, quando questa funzione restituisce correttamente, punta all'oggetto IContextMenu che rappresenta il menu di scelta rapida.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Vedi anche

SHCreateDefaultContextMenu