Metodo IPersistFolder::Initialize (shobjidl_core.h)

Indica a un oggetto cartella shell di inizializzarsi in base alle informazioni passate.

Sintassi

HRESULT Initialize(
  PCIDLIST_ABSOLUTE pidl
);

Parametri

pidl

Tipo: LPCITEMIDLIST

Indirizzo della struttura ITEMIDLIST (elenco identificatore elemento) che specifica la posizione assoluta della cartella.

Valore restituito

Tipo: HRESULT

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

Commenti

Tutti gli oggetti che implementano l'interfaccia IShellFolder da usare nello spazio dei nomi di Shell devono implementare questo metodo. Quando il percorso di una cartella nello spazio dei nomi non è una considerazione pertinente, questo metodo può semplicemente restituire S_OK. Quando il percorso è rilevante per la cartella, è necessario archiviare l'IDLIST completo passato per un riferimento successivo.

Ad esempio, se l'implementazione della cartella deve costruire un puntatore completo a un elenco di elementi (PIDL) agli elementi che contiene, il PIDL passato a questo metodo deve essere usato per costruire i PIDL completi.

Requisiti

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