Función de devolución de llamada pfnIsFileSupportedName (mssip.h)

  • Artículo

La función de devolución de llamada pfnIsFileSupportedName consulta los paquetes de interfaz de asunto (SIP) enumerados en el registro para determinar qué SIP controla el tipo de archivo.

Sintaxis

pfnIsFileSupportedName Pfnisfilesupportedname;

BOOL Pfnisfilesupportedname(
  [in]  WCHAR *pwszFileName,
  [out] GUID *pgSubject
)
{...}

Parámetros

[in] pwszFileName

Puntero a una cadena terminada en null que contiene la ruta de acceso absoluta al archivo que va a procesar el SIP.

[out] pgSubject

GUID que identifica el SIP que controla el tipo de archivo.

Valor devuelto

El valor devuelto es TRUE si la función se realiza correctamente; FALSE si se produce un error en la función. Si se produce un error en la función , llame a la función GetLastError para determinar el motivo del error.

Comentarios

Si el SIP admite el tipo de archivo pasado por hfile, la función devuelve TRUE y establece pgSubject en el GUID que identifica el SIP para controlar el tipo de archivo.

Cada SIP implementa su propia versión de la función que determina si se admite el tipo de archivo. El nombre específico de la función puede variar en función de la implementación del SIP, pero la firma de la función coincidirá con la de la estructura SIP_ADD_NEWPROVIDER .

Los SIP deben admitir un conjunto limitado de tipos de archivo y extensiones de archivo. La función fileSupportedName debe comprobar que el archivo proporcionado coincide con una de las extensiones de archivo admitidas por el SIP. Por ejemplo, el SIP de WSH solo admite la siguiente lista de extensiones de archivo y comprueba que el archivo en validación es miembro de la lista siguiente: .js, .jse, .vbe, .vbs o .wsf.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mssip.h

Consulte también

pfnIsFileSupported