Funzione SHAssocEnumHandlers (shobjidl_core.h)

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