Condividi tramite

Funzione SHBindToParent (shlobj_core.h)

  • Articolo

Accetta un puntatore a un elenco di identificatori di elemento completo (PIDL) e restituisce un puntatore di interfaccia specificato nell'oggetto padre.

Sintassi

SHSTDAPI SHBindToParent(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  REFIID            riid,
  [out] void              **ppv,
  [out] PCUITEMID_CHILD   *ppidlLast
);

Parametri

[in] pidl

Tipo: PCIDLIST_ABSOLUTE

PIDL dell'elemento.

[in] riid

Tipo: REFIID

REFIID di una delle interfacce esposte dall'oggetto padre dell'elemento.

[out] ppv

Tipo: VOID**

Puntatore all'interfaccia specificata da riid. Al termine, è necessario rilasciare l'oggetto .

[out] ppidlLast

Tipo: PCUITEMID_CHILD*

PIDL dell'elemento rispetto alla cartella padre. Questo PIDL può essere usato con molti dei metodi supportati dalle interfacce della cartella padre. Se si imposta ppidlLast su NULL, il file PIDL non viene restituito.

NotaSHBindToParent non alloca un nuovo PIDL; riceve semplicemente un puntatore tramite questo parametro. Pertanto, non si è responsabili della liberazione di questa risorsa.
 

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 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h (includere Shlobj.h)
Libreria Shell32.lib
DLL Shell32.dll (versione 5.0 o successiva)