SHCreateItemFromParsingName-Funktion (shobjidl_core.h)

Erstellt und initialisiert ein Shellelementobjekt aus einem Analysenamen.

Syntax

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

Parameter

[in] pszPath

Typ: PCWSTR

Ein Zeiger auf einen Anzeigenamen.

[in, optional] pbc

Typ: IBindCtx*

Optional. Ein Zeiger auf einen Bindungskontext, der verwendet wird, um Parameter als Eingaben und Ausgaben an die Analysefunktion zu übergeben. Diese übergebenen Parameter sind häufig spezifisch für die Datenquelle und werden von den Datenquellenbesitzern dokumentiert. Beispielsweise akzeptiert die Dateisystemdatenquelle den zu analysierenden Namen (als WIN32_FIND_DATA-Struktur ) mithilfe des STR_FILE_SYS_BIND_DATA bind-Kontextparameters.

STR_PARSE_PREFER_FOLDER_BROWSING können übergeben werden, um anzugeben, dass URLs nach Möglichkeit mithilfe der Dateisystemdatenquelle analysiert werden. Erstellen Sie mithilfe von CreateBindCtx ein Bindungskontextobjekt, und füllen Sie die Werte mit IBindCtx::RegisterObjectParam auf. Eine vollständige Liste dieser Schlüssel finden Sie unter Binden von Kontextzeichenfolgenschlüsseln . Ein Beispiel für die Verwendung dieses Parameters finden Sie im Beispiel zum Analysieren mit Parametern .

Wenn keine Daten an die Analysefunktion übergeben oder von dieser empfangen werden, kann dieser Wert NULL sein.

[in] riid

Typ: REFIID

Ein Verweis auf die IID der Schnittstelle, die über ppv abgerufen werden soll, in der Regel IID_IShellItem oder IID_IShellItem2.

[out] ppv

Typ: void**

Wenn diese Methode erfolgreich zurückgegeben wird, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel IShellItem oder IShellItem2.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Es wird empfohlen, das makro IID_PPV_ARGS zu verwenden, das in Objbase.h definiert ist, um die Parameter riid und ppv zu packen. Dieses Makro stellt die richtige IID basierend auf der Schnittstelle bereit, auf die der Wert in ppv verweist, wodurch die Möglichkeit eines Codierungsfehlers in riid vermieden wird, der zu unerwarteten Ergebnissen führen könnte.

Anforderungen