Metodo IShellFolder::BindToStorage (shobjidl_core.h)

Articolo
03/15/2023

Richiede un puntatore all'interfaccia di archiviazione di un oggetto.

Sintassi

HRESULT BindToStorage(
  [in]  PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
  [in]  REFIID             riid,
  [out] void               **ppv
);

Parametri

[in] pidl

Tipo: PCUIDLIST_RELATIVE

Indirizzo di una struttura ITEMIDLIST che identifica la sottocartella relativa alla relativa cartella padre. La struttura deve contenere esattamente una struttura SHITEMID seguita da uno zero finale.

[in] pbc

Tipo: IBindCtx*

Indirizzo facoltativo di un'interfaccia IBindCtx in un oggetto contesto di associazione da utilizzare durante questa operazione. Se questo parametro non viene usato, impostarlo su NULL. 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

IID dell'interfaccia di archiviazione richiesta. Per recuperare un puntatore all'interfaccia IStream, IStorage o IPropertySetStorage , impostare riid rispettivamente su IID_IStream, IID_IStorage o IID_IPropertySetStorage.

[out] ppv

Tipo: void**

Indirizzo che riceve il puntatore dell'interfaccia specificato da riid. Se si verifica un errore, viene restituito un puntatore NULL in questo indirizzo.

Valore restituito

Tipo: HRESULT

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

Commenti

Le estensioni dello spazio dei nomi consentono alle applicazioni di eseguire il binding a un oggetto che rappresenta l'archiviazione di un elemento. Se questa opzione è supportata, IShellFolder::BindToStorage restituisce un puntatore di interfaccia specificato che può quindi essere usato per accedere al contenuto dell'oggetto. Per altre informazioni, vedere le informazioni di riferimento su IMoniker::BindToStorage .

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 4.0 o successiva)

Condividi tramite