AssocGetDetailsOfPropKey-Funktion (shlobj_core.h)

Ruft den Wert für einen bestimmten Eigenschaftenschlüssel mithilfe der Dateizuordnungsinformationen ab, die von den Namespaceerweiterungen bereitgestellt werden.

Syntax

SHSTDAPI AssocGetDetailsOfPropKey(
  [in]  IShellFolder      *psf,
  [in]  PCUITEMID_CHILD   pidl,
  [in]  const PROPERTYKEY *pkey,
  [out] VARIANT           *pv,
  [out] BOOL              *pfFoundPropKey
);

Parameter

[in] psf

Typ: IShellFolder*

Ein Zeiger auf den Shellordner, für den die Details des Eigenschaftenschlüssels der Dateizuordnung abgerufen werden.

[in] pidl

Typ: PCUITEMID_CHILD

Die PIDL des untergeordneten Elements, für das die Dateizuordnungen angefordert werden.

[in] pkey

Typ: PROPERTYKEY*

Ein Zeiger auf den Eigenschaftsschlüssel, der abgerufen wird.

[out] pv

Typ: VARIANT*

Wenn diese Funktion zurückgibt, enthält die Details des angegebenen Eigenschaftenschlüssels.

[out] pfFoundPropKey

Typ: BOOL*

Wenn diese Funktion zurückgibt, enthält ein Flag, das TRUE ist, wenn der Eigenschaftsschlüssel gefunden wurde, andernfalls FALSE.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Funktion darf nur von Implementierern von IShellFolder-Namespaceerweiterungen verwendet werden. Andere aufrufende Anwendungen sollten IShellFolder2::GetDetailsEx verwenden, um einen Wert für einen PROPERTYKEY abzurufen. Diese Funktion soll von Implementierungen von IShellFolder-Namespaceerweiterungen verwendet werden.

Die bereitgestellte Namespaceerweiterung muss die Verwendung dieser API auf eine der folgenden drei Arten unterstützen.

1. Wenn die bereitgestellten Namespaceerweiterungen das Abrufen einer IQueryAssociations-Schnittstelle für das Element durch Implementieren von IShellFolder::GetUIObjectOf(..., IID_IQueryAssociations, ...) unterstützen, verwendet AssocGetDetailsOfPropKey die bereitgestellte Dateizuordnungs-API, um den Wert für den Eigenschaftsschlüssel abzurufen.
2. Wenn die bereitgestellte Namespaceerweiterung SFGAO_FILESYSTEM für das Element aus IShellFolder::GetAttributesOf zurückgibt und einen Analysenamen für das Element bereitstellt, verwendet AssocGetDetailsOfPropKey die standardmäßigen Dateisystemzuordnungen, um den Wert für den Eigenschaftsschlüssel abzurufen.
3. Wenn die bereitgestellte Namespaceerweiterung SFGAO_FOLDER | SFGAO_BROWSABLE für das Element aus IShellFolder::GetAttributesOf zurückgibt, verwendet AssocGetDetailsOfPropKey die Dateizuordnung für Ordner (ASSOCCLASS_FOLDER), um den Wert für den Eigenschaftsschlüssel abzurufen.

Wenn der zu implementierende ShellFolder Elemente enthält, die über den Dateizuordnungsmechanismus erweiterbar sind, können Sie diese Funktion verwenden, um PropertyKeys abzurufen, die für eine bestimmte Dateizuordnung deklariert sind. Wenn beispielsweise ein bestimmter Shellordner einen Detailbereich steuert und die in diesem Bereich angezeigten Eigenschaften von Dateinamenerweiterungen von Drittanbietern gesteuert werden sollen, können Sie diese Funktion verwenden, um PKEY_PropList_PreviewDetails zurückzugeben. Dieser Schlüssel verfügt über einen Wert, der in der Registrierung für diese Dateinamenerweiterung mit einer durch Semikolon getrennten Liste von Eigenschaften deklariert wird. Es gibt eine Liste der definierten Eigenschaften der Dateinamenerweiterung in der Registrierung. Diese Liste enthält, ist jedoch nicht beschränkt auf Folgendes:

• PKEY_PropList_PreviewDetails
• PKEY_PropList_PreviewTitle
• PKEY_PropList_FullDetails
• PKEY_PropList_TileInfo
• PKEY_PropList_ExtendedTileInfo
• PKEY_PropList_InfoTip
• PKEY_PropList_QuickTip
• PKEY_PropList_FileOperationPrompt
• PKEY_PropList_ConflictPrompt
• PKEY_PropList_SetDefaultsFor
• PKEY_PropList_NonPersonal
• PKEY_NewMenuPreferredTypes
• PKEY_NewMenuAllowedTypes

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (shlobj.h einschließen)
DLL	Shell32.dll