Método IShellFolder::BindToStorage (shobjidl_core.h)

Solicita um ponteiro para a interface de armazenamento de um objeto.

Sintaxe

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

Parâmetros

[in] pidl

Tipo: PCUIDLIST_RELATIVE

O endereço de uma estrutura ITEMIDLIST que identifica a subpasta em relação à pasta pai. A estrutura deve conter exatamente uma estrutura SHITEMID seguida por um zero de terminação.

[in] pbc

Tipo: IBindCtx*

O endereço opcional de uma interface IBindCtx em um objeto de contexto de associação a ser usado durante essa operação. Se esse parâmetro não for usado, defina-o como NULL. Como o suporte para pbc é opcional para implementações de objeto de pasta, algumas pastas podem não dar suporte ao uso de contextos de associação.

[in] riid

Tipo: REFIID

O IID da interface de armazenamento solicitada. Para recuperar um ponteiro de interface IStream, IStorage ou IPropertySetStorage , defina riid como IID_IStream, IID_IStorage ou IID_IPropertySetStorage, respectivamente.

[out] ppv

Tipo: void**

O endereço que recebe o ponteiro de interface especificado por riid. Se ocorrer um erro, um ponteiro NULL será retornado nesse endereço.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

As extensões de namespace têm a opção de permitir que os aplicativos se associem a um objeto que representa o armazenamento de um item. Se essa opção tiver suporte, IShellFolder::BindToStorage retornará um ponteiro de interface especificado que pode ser usado para acessar o conteúdo do objeto. Consulte a referência IMoniker::BindToStorage para obter mais discussões.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shell32.dll (versão 4.0 ou posterior)