Funzione SHBindToParent (shlobj_core.h)

Articolo
03/13/2024

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)

Share via