Funzione SHCreateItemFromParsingName (shobjidl_core.h)

Articolo
08/26/2023

Crea e inizializza un oggetto Shell da un nome di analisi.

Sintassi

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

Parametri

[in] pszPath

Tipo: PCWSTR

Puntatore a un nome visualizzato.

[in, optional] pbc

Tipo: IBindCtx*

facoltativo. Puntatore a un contesto di associazione usato per passare parametri come input e output alla funzione di analisi. Questi parametri passati sono spesso specifici dell'origine dati e sono documentati dai proprietari dell'origine dati. Ad esempio, l'origine dati del file system accetta il nome analizzato (come struttura WIN32_FIND_DATA ), usando il parametro di contesto di associazione STR_FILE_SYS_BIND_DATA .

STR_PARSE_PREFER_FOLDER_BROWSING possibile passare per indicare che gli URL vengono analizzati usando l'origine dati del file system, quando possibile. Costruire un oggetto contesto di associazione usando CreateBindCtx e popolare i valori usando IBindCtx::RegisterObjectParam. Per un elenco completo di questi elementi, vedere Bind Context String Keys (Associa chiavi stringa di contesto ). Vedere l'esempio di analisi con parametri per un esempio dell'uso di questo parametro.

Se non vengono passati o ricevuti dati dalla funzione di analisi, questo valore può essere NULL.

[in] riid

Tipo: REFIID

Riferimento all'IID dell'interfaccia da recuperare tramite ppv, in genere IID_IShellItem o IID_IShellItem2.

[out] ppv

Tipo: void**

Quando questo metodo viene restituito correttamente, contiene il puntatore di interfaccia richiesto in riid. Si tratta in genere di IShellItem o IShellItem2.

Valore restituito

Tipo: HRESULT

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

Commenti

È consigliabile usare la macro IID_PPV_ARGS , definita in Objbase.h, per creare un pacchetto dei parametri riid e ppv . Questa macro fornisce l'IID corretto in base all'interfaccia a cui punta il valore in ppv, che elimina la possibilità di un errore di codifica in riid che potrebbe causare risultati imprevisti.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll

Condividi tramite