AssocGetDetailsOfPropKey function (shlobj_core.h)
Retrieves the value for a given property key using the file association information provided by the Namespace Extensions.
Syntax
SHSTDAPI AssocGetDetailsOfPropKey(
[in] IShellFolder *psf,
[in] PCUITEMID_CHILD pidl,
[in] const PROPERTYKEY *pkey,
[out] VARIANT *pv,
[out] BOOL *pfFoundPropKey
);
Parameters
[in] psf
Type: IShellFolder*
A pointer to the shell folder for which the details of the property key of the file association are being retrieved.
[in] pidl
Type: PCUITEMID_CHILD
The PIDL of the child item for which the file associations are being requested.
[in] pkey
Type: PROPERTYKEY*
A pointer to the property key that is being retrieved.
[out] pv
Type: VARIANT*
When this function returns, contains the details of the given property key.
[out] pfFoundPropKey
Type: BOOL*
When this function returns, contains a flag that is TRUE if the property key was found, otherwise FALSE.
Return value
Type: HRESULT
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
This function is to be used only by implementers of IShellFolder Namespace Extensions. Other calling applications should use IShellFolder2::GetDetailsEx to get a value for a PROPERTYKEY. This function is to be used by implementers of IShellFolder Namespace Extensions.
The provided namespace extension must support the use of this API in one of the following three ways.
- If the provided Namespace Extensions supports retrieving an IQueryAssociations interface for the item by implementing IShellFolder::GetUIObjectOf(..., IID_IQueryAssociations, ...), then AssocGetDetailsOfPropKey will use the provided file associations API to retrieve the value for the property key.
- If the provided namespace extension returns SFGAO_FILESYSTEM for the item from IShellFolder::GetAttributesOf and provides a parsing name for the item, then AssocGetDetailsOfPropKey will use the standard file system associations to retrieve the value for the property key.
- If the provided namespace extension returns SFGAO_FOLDER | SFGAO_BROWSABLE for the item from IShellFolder::GetAttributesOf, then AssocGetDetailsOfPropKey will use the file association for folders (ASSOCCLASS_FOLDER) to retrieve the value for the property key.
- 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
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2008 [desktop apps only] |
Target Platform | Windows |
Header | shlobj_core.h (include Shlobj.h) |
DLL | Shell32.dll |
Σχόλια
https://aka.ms/ContentUserFeedback.
Σύντομα διαθέσιμα: Καθ' όλη τη διάρκεια του 2024 θα καταργήσουμε σταδιακά τα ζητήματα GitHub ως μηχανισμό ανάδρασης για το περιεχόμενο και θα το αντικαταστήσουμε με ένα νέο σύστημα ανάδρασης. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα:Υποβολή και προβολή σχολίων για