Condividi tramite

Funzione SHAssocEnumHandlers (shobjidl_core.h)

  • Articolo

Restituisce un oggetto enumerazione per un set specificato di gestori dell'estensione del nome file.

Sintassi

SHSTDAPI SHAssocEnumHandlers(
  [in]  PCWSTR             pszExtra,
  [in]  ASSOC_FILTER       afFilter,
  [out] IEnumAssocHandlers **ppEnumHandler
);

Parametri

[in] pszExtra

Tipo: PCWSTR

Puntatore a un buffer con terminazione Null che contiene un'unica estensione del tipo di file, ad esempio ".jpg". Vengono enumerati solo i gestori associati all'estensione specificata. Questo parametro potrebbe non essere NULL.

[in] afFilter

Tipo: ASSOC_FILTER

Specifica il filtro del gestore di enumerazione applicato all'elenco completo dei gestori risultanti dal valore specificato in pszExtra. Uno dei valori seguenti.

Valore Descrizione
ASSOC_FILTER_NONE Restituisce tutti i gestori.
ASSOC_FILTER_RECOMMENDED Restituisce solo i gestori consigliati. Un gestore imposta lo stato consigliato nel Registro di sistema quando viene installato. Uno stato iniziale non consigliato può essere promosso a consigliato in seguito all'azione dell'utente.

[out] ppEnumHandler

Tipo: IEnumAssocHandlers**

Quando termina, questo metodo contiene l'indirizzo di un puntatore a un oggetto IEnumAssocHandlers .

Valore restituito

Tipo: HRESULT

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

Requisiti

Requisito Valore
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)
Libreria Shell32.lib
DLL Shell32.dll