Funzione SHBindToObject (shlobj_core.h)

Articolo
03/15/2023

Recupera e associa a un oggetto specificato usando il metodo IShellFolder::BindToObject dello spazio dei nomi Shell.

Sintassi

SHSTDAPI SHBindToObject(
        IShellFolder       *psf,
        PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
        REFIID             riid,
  [out] void               **ppv
);

Parametri

psf

Tipo: IShellFolder*

Puntatore a IShellFolder. Questo parametro può essere NULL. Se psf è NULL, questo indica che il parametro pidl è relativo al desktop. In questo caso, pidl deve specificare un ITEMIDLIST assoluto.

pidl

Tipo: PCUIDLIST_RELATIVE

Puntatore a una costante ITEMIDLIST da associare a tale oggetto rispetto a psf. Se psf è NULL, si tratta di un elemento ITEMIDLIST assoluto rispetto alla cartella desktop.

[in] pbc

Tipo: IBindCtx*

Un puntatore all'interfaccia IBindCtx in un oggetto contesto di associazione da usare durante questa operazione. Se questo parametro non viene usato, impostarlo su NULL. Poiché il supporto per pbc è facoltativo per le implementazioni dell'oggetto cartelle, alcune cartelle potrebbero non supportare l'uso di contesti di associazione.

riid

Tipo: REFIID

Identificatore dell'interfaccia da restituire.

[out] ppv

Tipo: void**

Quando questo metodo restituisce, contiene il puntatore dell'interfaccia come specificato in riid all'oggetto associato. Se si verifica un errore, contiene un puntatore NULL .

Valore restituito

Tipo: HRESULT

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

Commenti

Nota Questa è una funzione helper che ottiene l'oggetto desktop chiamando SHGetDesktopFolder.

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 (include Shlobj.h)
DLL	Shell32.dll

Vedi anche

IShellFolder

IShellFolder::BindToObject

Condividi tramite