Fonction NPGetDirectoryType (npapi.h)

Article
03/06/2024

Détermine le type d’un répertoire réseau. La fonction NPGetDirectoryType est utilisée par le Gestionnaire de fichiers.

Syntaxe

DWORD NPGetDirectoryType(
  [in] LPWSTR lpName,
  [in] LPINT  lpType,
  [in] BOOL   bFlushCache
);

Paramètres

[in] lpName

Pointeur vers le nom complet du répertoire. Le fournisseur réseau retourne le type à l’adresse pointée par lpType. Si la valeur retournée dans lpType est égale à zéro ou si le fournisseur réseau retourne une erreur, le Gestionnaire de fichiers affiche le répertoire sous la forme d’un répertoire « normal ».

[in] lpType

Pointeur vers une valeur définie par le fournisseur réseau. Cette valeur est utilisée pour modifier l’affichage de l’arborescence de lecteur dans le Gestionnaire de fichiers. De cette façon, le fournisseur réseau peut afficher des répertoires spéciaux à l’utilisateur.

[in] bFlushCache

Définissez la valeur TRUE lorsque le Gestionnaire de fichiers appelle MPR pour obtenir le type de répertoire pour la première fois lors du repeint d’une fenêtre lors de l’actualisation. Par la suite, il sera FALSE. Cela permet à un fournisseur d’optimiser les performances s’il souhaite simplement lire les données d’un lecteur une seule fois, puis les mettre en cache jusqu’à l’actualisation suivante.

Valeur retournée

Cette fonction doit retourner WN_SUCCESS si elle réussit. Dans le cas contraire, il doit retourner un code d’erreur, qui peut inclure les éléments suivants.

Code de retour	Description
WN_NOT_SUPPORTED	NPGetDirectoryType n’est pas pris en charge.

Remarques

Le Gestionnaire de fichiers fournit sa propre icône pour tous les répertoires réseau spéciaux ; autrement dit, lorsque lpType est défini sur une valeur différente de zéro, le Gestionnaire de fichiers affiche une icône de dossier spécial.

L’implémentation de cette fonction doit être performante ou rapide, car l’appel se produit pendant que le Gestionnaire de fichiers peint l’arborescence de répertoires.

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	npapi.h

Partager via