Função SHCreateItemFromParsingName (shobjidl_core.h)

Cria e inicializa um objeto de item de Shell com base na análise de um nome.

Sintaxe

SHSTDAPI SHCreateItemFromParsingName(
  [in]           PCWSTR   pszPath,
  [in, optional] IBindCtx *pbc,
  [in]           REFIID   riid,
  [out]          void     **ppv
);

Parâmetros

[in] pszPath

Tipo: PCWSTR

Um ponteiro para um nome de exibição.

[in, optional] pbc

Tipo: IBindCtx*

Opcional. Um ponteiro para um contexto de associação usado para passar parâmetros como entradas e saídas para a função de análise. Esses parâmetros passados geralmente são específicos da fonte de dados e são documentados pelos proprietários da fonte de dados. Por exemplo, a fonte de dados do sistema de arquivos aceita o nome que está sendo analisado (como uma estrutura WIN32_FIND_DATA ), usando o parâmetro de contexto de associação STR_FILE_SYS_BIND_DATA .

STR_PARSE_PREFER_FOLDER_BROWSING pode ser passado para indicar que as URLs são analisadas usando a fonte de dados do sistema de arquivos quando possível. Construa um objeto de contexto de associação usando CreateBindCtx e preencha os valores usando IBindCtx::RegisterObjectParam. Consulte Associar chaves de cadeia de caracteres de contexto para obter uma lista completa dessas chaves. Consulte o Exemplo de Análise com Parâmetros para obter um exemplo do uso desse parâmetro.

Se nenhum dado estiver sendo passado ou recebido da função de análise, esse valor poderá ser NULL.

[in] riid

Tipo: REFIID

Uma referência à IID da interface a ser recuperada por meio de ppv, normalmente IID_IShellItem ou IID_IShellItem2.

[out] ppv

Tipo: void**

Quando esse método retorna com êxito, contém o ponteiro de interface solicitado em riid. Normalmente, isso é IShellItem ou IShellItem2.

Valor retornado

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Recomendamos que você use a macro IID_PPV_ARGS , definida em Objbase.h, para empacotar os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação no riid que pode levar a resultados inesperados.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shell32.dll