Fonction de rappel pfnIsFileSupportedName (mssip.h)

La fonction de rappel pfnIsFileSupportedName interroge les packages d’interface d’objet (SIP) répertoriés dans le Registre pour déterminer quel SIP gère le type de fichier.

Syntaxe

pfnIsFileSupportedName Pfnisfilesupportedname;

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

Paramètres

[in] pwszFileName

Pointeur vers une chaîne terminée par null qui contient le chemin absolu du fichier à traiter par le SIP.

[out] pgSubject

GUID identifiant le SIP qui gère le type de fichier.

Valeur retournée

La valeur de retour est TRUE si la fonction réussit ; FALSE si la fonction échoue. Si la fonction échoue, appelez la fonction GetLastError pour déterminer la raison de l’échec.

Remarques

Si le SIP prend en charge le type de fichier transmis par hfile, la fonction retourne TRUE et définit pgSubject sur le GUID qui identifie le SIP pour gérer le type de fichier.

Chaque SIP implémente sa propre version de la fonction qui détermine si le type de fichier est pris en charge. Le nom spécifique de la fonction peut varier en fonction de l’implémentation du SIP, mais la signature de la fonction correspondra à celle de la structure SIP_ADD_NEWPROVIDER .

Les cartes IP doivent prendre en charge un ensemble limité de types de fichiers et d’extensions de fichier. La fonction fileSupportedName doit case activée que le fichier fourni correspond à l’une des extensions de fichier prises en charge par le SIP. Par instance, le PROTOCOLE SIP WSH prend uniquement en charge la liste suivante d’extensions de fichier et vérifie que le fichier en cours de validation est membre de la liste suivante : .js, .jse, .vbe, .vbs ou .wsf.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mssip.h

Voir aussi

pfnIsFileSupported