Funzione SHBindToFolderIDListParentEx (shlobj_core.h)

Articolo
03/02/2024

Estende la funzione SHBindToFolderIDListParent consentendo al chiamante di specificare un contesto di associazione.

Sintassi

SHSTDAPI SHBindToFolderIDListParentEx(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [in, optional]  IBindCtx           *ppbc,
  [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 IDList passato è relativo al desktop.

[in] pidl

Tipo: PCUIDLIST_RELATIVE

UN FILE PIDL a cui eseguire l'associazione rispetto a psfRoot. Se psfRoot è NULL, si tratta di un IDList assoluto relativo alla cartella desktop.

[in, optional] ppbc

Tipo: IBindCtx*

Puntatore all'interfaccia IBindCtx su un oggetto contesto di associazione da utilizzare durante questa operazione. Se questo parametro non viene usato, impostarlo su NULL, che equivale a chiamare la funzione SHBindToFolderIDListParent . Poiché il supporto per pbc è facoltativo per le implementazioni di oggetti cartella, alcune cartelle potrebbero non supportare l'uso di contesti di associazione.

[in] riid

Tipo: REFIID

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

[out] ppv

Tipo: void**

Quando questa funzione viene restituita, contiene il puntatore di interfaccia richiesto in riid. Si tratta in genere di 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 .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h (includere Shlobj.h)
DLL	Shell32.dll

Vedi anche

SHBindToFolderIDListParent

Condividi tramite