Funzione AssocGetPerceivedType (shlwapi.h)

Recupera il tipo percepito di un file in base all'estensione.

Sintassi

LWSTDAPI AssocGetPerceivedType(
  [in]            PCWSTR        pszExt,
  [out]           PERCEIVED     *ptype,
  [out]           PERCEIVEDFLAG *pflag,
  [out, optional] PWSTR         *ppszType
);

Parametri

[in] pszExt

Tipo: PCWSTR

Puntatore a un buffer contenente l'estensione del file. Ciò deve includere il periodo iniziale, ad esempio ".txt".

[out] ptype

Tipo: PERCEPITO*

Puntatore a un valore PERCEPITO che indica il tipo percepito.

[out] pflag

Tipo: PERCEIVEDFLAG*

Puntatore a un valore che indica l'origine delle informazioni sul tipo percepito. Uno o più dei valori seguenti.

PERCEIVEDFLAG_UNDEFINED (0x0000)

Non è stato trovato alcun tipo percepito (PERCEIVED_TYPE_UNSPECIFIED).

PERCEIVEDFLAG_SOFTCODED (0x0001)

Il tipo percepito è stato determinato tramite un'associazione nel Registro di sistema.

PERCEIVEDFLAG_HARDCODED (0x0002)

Il tipo percepito è intrinsecamente noto a Windows.

PERCEIVEDFLAG_NATIVESUPPORT (0x0004)

Il tipo percepito è stato determinato tramite un codec fornito con Windows.

PERCEIVEDFLAG_GDIPLUS (0x0010)

Il tipo percepito è supportato dalla libreria GDI+.

PERCEIVEDFLAG_WMSDK (0x0020)

Il tipo percepito è supportato da Windows Media SDK.

PERCEIVEDFLAG_ZIPFOLDER (0x0040)

Il tipo percepito è supportato dalle cartelle compresse di Windows.

[out, optional] ppszType

Tipo: PWSTR*

Se la funzione restituisce un codice di esito positivo, questo contiene l'indirizzo di un puntatore a un buffer che riceve la stringa di tipo percepita, ad esempio "text" o "video". Questo valore può essere NULL.

Valore restituito

Tipo: HRESULT

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

Commenti

Questa funzione confronta prima l'estensione con un set di estensioni hardcoded noto per Windows. Se la ricerca non riesce a rivelare una corrispondenza, le associazioni registrate in HKEY_CLASSES_ROOT vengono cercate una chiave corrispondente all'estensione e contiene un valore PerceivedType. Se questo valore viene trovato, il set di estensioni viene nuovamente cercato una corrispondenza. Se non viene trovata alcuna corrispondenza, il tipo percepito viene determinato PERCEIVED_TYPE_CUSTOM. Se non viene trovata una chiave corrispondente all'estensione o a un valore PerceivedType, il tipo percepito viene segnalato come PERCEIVED_TYPE_UNSPECIFIED.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 6.0 o successiva)