Share via

Función AssocGetPerceivedType (shlwapi.h)

  • Artículo

Recupera el tipo percibido de un archivo en función de su extensión.

Sintaxis

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

Parámetros

[in] pszExt

Tipo: PCWSTR

Puntero a un búfer que contiene la extensión del archivo. Esto debe incluir el período inicial, por ejemplo, ".txt".

[out] ptype

Tipo: PERCIBIDO*

Puntero a un valor PERCEIVED que indica el tipo percibido.

[out] pflag

Tipo: PERCEIVEDFLAG*

Puntero a un valor que indica el origen de la información de tipo percibido. Uno o varios de los valores siguientes.

PERCEIVEDFLAG_UNDEFINED (0x0000)

No se encontró ningún tipo percibido (PERCEIVED_TYPE_UNSPECIFIED).

PERCEIVEDFLAG_SOFTCODED (0x0001)

El tipo percibido se determinó a través de una asociación en el registro.

PERCEIVEDFLAG_HARDCODED (0x0002)

El tipo percibido se conoce de forma inherente a Windows.

PERCEIVEDFLAG_NATIVESUPPORT (0x0004)

El tipo percibido se determinó a través de un códec proporcionado con Windows.

PERCEIVEDFLAG_GDIPLUS (0x0010)

La biblioteca GDI+ admite el tipo percibido.

PERCEIVEDFLAG_WMSDK (0x0020)

El tipo percibido es compatible con el SDK de Windows Media.

PERCEIVEDFLAG_ZIPFOLDER (0x0040)

El tipo percibido es compatible con las carpetas comprimidas de Windows.

[out, optional] ppszType

Tipo: PWSTR*

Si la función devuelve un código correcto, contiene la dirección de un puntero a un búfer que recibe la cadena de tipo percibido, por ejemplo"texto" o "vídeo". Este valor puede ser NULL.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Esta función compara primero la extensión con un conjunto codificado de forma rígida de extensiones conocidas para Windows. Si esa búsqueda no puede revelar una coincidencia, se buscan las asociaciones registradas en HKEY_CLASSES_ROOT una clave que coincide con la extensión y contiene un valor PerceivedType. Si se encuentra ese valor, se vuelve a buscar una coincidencia en el conjunto de extensiones. Si no se encuentra ninguna coincidencia, se determina que el tipo percibido es PERCEIVED_TYPE_CUSTOM. Si no se encuentra una clave que coincida con la extensión o un valor PerceivedType, el tipo percibido se notifica como PERCEIVED_TYPE_UNSPECIFIED.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 6.0 o posterior)