Funzione SHBindToFolderIDListParent (shlobj_core.h)

Dato un elemento dello spazio dei nomi shell specificato sotto forma di una cartella e un elenco di identificatori di elemento relativo a tale cartella, questa funzione viene associata all'elemento padre dell'elemento dello spazio dei nomi e, facoltativamente, restituisce un puntatore al componente finale dell'elenco di identificatori di elemento.

Sintassi

SHSTDAPI SHBindToFolderIDListParent(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [in]            REFIID             riid,
  [out]           void               **ppv,
  [out, optional] PCUITEMID_CHILD    *ppidlLast
);

Parametri

[in, optional] psfRoot

Tipo: IShellFolder*

Puntatore a un oggetto cartella Shell. Se psfRoot è NULL, indica che l'IDList passato è relativo al desktop.

[in] pidl

Tipo: PCUIDLIST_RELATIVE

PiDL da associare a, rispetto a psfRoot. Se psfRoot è NULL, si tratta di un IDList assoluto relativo alla cartella desktop.

[in] riid

Tipo: REFIID

Riferimento all'ID dell'interfaccia desiderato. Questo è in genere IID_IShellFolder o IID_IShellFolder2, ma può essere qualsiasi elemento supportato dalla cartella di destinazione.

[out] ppv

Tipo: void**

Quando questa funzione restituisce, contiene il puntatore dell'interfaccia richiesto in riid. Questo è in genere IShellFolder o IShellFolder2, ma può essere qualsiasi elemento supportato dalla cartella di destinazione.

[out, optional] ppidlLast

Tipo: PCUITEMID_CHILD*

Puntatore all'ultimo ID del parametro pidl ed è un ID figlio relativo alla cartella padre restituita in ppv. Questo valore può essere NULL.

Valore restituito

Tipo: HRESULT

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

Commenti

Requisiti

Vedi anche

SHBindToFolderIDListParentEx