Metodo IPersistFolder3::InitializeEx (shobjidl_core.h)

  • Articolo

Inizializza una cartella e specifica il relativo percorso nello spazio dei nomi. Se la cartella è un collegamento, questo metodo specifica anche il percorso della cartella di destinazione.

Sintassi

HRESULT InitializeEx(
  [in] IBindCtx                         *pbc,
  [in] PCIDLIST_ABSOLUTE                pidlRoot,
  [in] const PERSIST_FOLDER_TARGET_INFO *ppfti
);

Parametri

[in] pbc

Tipo: IBindCtx*

Puntatore a un oggetto IBindCtx che fornisce il contesto di associazione. Questo parametro può essere NULL.

[in] pidlRoot

Tipo: LPCITEMIDLIST

Puntatore a un PIDL completo che specifica la posizione assoluta di una cartella o di un collegamento a una cartella. L'applicazione chiamante è responsabile dell'allocazione e della liberazione di questo PIDL.

[in] ppfti

Tipo: const PERSIST_FOLDER_TARGET_INFO*

Puntatore a una struttura PERSIST_FOLDER_TARGET_INFO che specifica il percorso della cartella di destinazione e i relativi attributi.

Se ppfti punta a una struttura valida, pidlRoot rappresenta un collegamento a una cartella.

Se ppfti è impostato su NULL, pidlRoot rappresenta una normale cartella. In questo caso , InitializeEx deve comportarsi come se Inizializza fosse stata chiamata.

Valore restituito

Tipo: HRESULT

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

Commenti

Questa funzione è una versione estesa di IPersistFolder::Initialize. Consente alla Shell di inizializzare i tasti di scelta rapida delle cartelle e le normali cartelle.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional con SP3, Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll (versione 5.0 o successiva)