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.

Nota Il numero massimo di chiavi del Registro di sistema è 16. I chiamanti devono applicare questo limite perché l'API non è. La mancata operazione può causare un danneggiamento della memoria.

 

[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

Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h (include Shlobj.h)
Libreria	Shell32.lib
DLL	Shell32.dll (versione 5.00 o successiva)

Vedi anche

SHCreateDefaultContextMenu