Share via

Funzione PSLookupPropertyHandlerCLSID (propsys.h)

  • Articolo

Ottiene l'identificatore di classe (CLSID) di un gestore di proprietà file registrato per computer.

Sintassi

PSSTDAPI PSLookupPropertyHandlerCLSID(
  [in]  PCWSTR pszFilePath,
  [out] CLSID  *pclsid
);

Parametri

[in] pszFilePath

Tipo: PCWSTR

Puntatore a un buffer Unicode con terminazione Null che contiene il percorso assoluto del file il cui gestore di proprietà CLSID viene richiesto.

[out] pclsid

Tipo: CLSID*

Quando questa funzione restituisce, contiene il gestore delle proprietà richiesto CLSID.

Valore restituito

Tipo: PSSTDAPI

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario.

Commenti

Per informazioni su come registrare il gestore, vedere Inizializzazione dei gestori delle proprietà.

Questa funzione restituisce solo i gestori registrati in HKEY_LOCAL_MACHINE.

La maggior parte delle applicazioni chiamante non deve chiamare questo metodo o usare CoCreateInstance per creare direttamente un gestore delle proprietà. Le chiamate alle applicazioni devono invece usare IShellItem2::GetPropertyStore per creare un archivio delle proprietà per un elemento shell in Windows Vista. IShellItem2::GetPropertyStore offre il set più grande di proprietà disponibili per un elemento shell e le opzioni più frequenti per personalizzare esattamente le proprietà da restituire.

Se non viene registrato alcun gestore di proprietà per il file specificato, questa funzione restituisce un codice di errore. In questo caso, potrebbe comunque essere possibile leggere determinate proprietà del file system dall'archivio delle proprietà restituite da IShellItem2::GetPropertyStore.

Le applicazioni che devono creare un gestore delle proprietà dal codice e che devono essere eseguite sia in Windows Vista che in Windows XP possono chiamare PSGetItemPropertyHandler per creare un archivio proprietà per un elemento shell tramite Microsoft Windows Desktop Search (WDS) ridistribuibile.

Esempio

Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare PSLookupPropertyHandlerCLSID.

CLSID clsid;

HRESULT hr = PSLookupPropertyHandlerCLSID(L"C:\\windows\\system32\\shell32.dll", &clsid);

if (SUCCEEDED(hr))
{
    // clsid contains the CLSID of the property handler used for 
    // C:\windows\system32\shell32.dll.
}

Requisiti

   
Client minimo supportato Windows XP con SP2, Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione propsys.h
Libreria Propsys.lib
DLL Propsys.dll (versione 6.0 o successiva)
Componente ridistribuibile Windows Desktop Search (WDS) 3.0

Vedi anche

IShellItem2::GetPropertyStore

PSGetItemPropertyHandler