Partager via


FONCTION NPPropertyDialog (npapi.h)

Appelée lorsque l’utilisateur clique sur un bouton ajouté à l’aide de la fonction NPPropertyDialog . La fonction NPPropertyDialog est appelée uniquement pour les propriétés réseau de fichiers et de répertoires.

Syntaxe

DWORD NPPropertyDialog(
  [in] HWND   hwndParent,
  [in] DWORD  iButtonDlg,
  [in] DWORD  nPropSel,
  [in] LPWSTR lpFileName,
  [in] DWORD  nType
);

Paramètres

[in] hwndParent

Handle de la fenêtre parente qui doit être propriétaire de la boîte de dialogue de propriété de fichier.

[in] iButtonDlg

Index du bouton qui a été appuyé.

Cet index spécifie la boîte de dialogue de propriété demandée, en commençant par une pour le premier bouton retourné par la fonction NPGetPropertyText . Si plusieurs noms de fichiers sont sélectionnés, 10 est ajouté à ce nombre. En d’autres termes, si plusieurs fichiers sont sélectionnés et que l’utilisateur appuie sur le premier bouton de propriété définie par le fournisseur, iButtonDlg aura la valeur 11. S’il n’y a qu’un seul fichier sélectionné et que l’utilisateur appuie sur le deuxième bouton de propriété réseau, iButtonDlg en aura deux.

[in] nPropSel

Spécifie sur quels éléments la boîte de dialogue de propriété doit agir. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
WNPS_FILE
Fichier unique.
WNPS_DIR
Un répertoire unique.
WNPS_MULT
Sélection de plusieurs fichiers, répertoires ou les deux.

[in] lpFileName

Pointeur vers les noms des éléments sur lequel la boîte de dialogue de propriété doit agir. Les seuls éléments pris en charge sont des fichiers et des répertoires, de sorte que les noms d’éléments sont des noms de fichiers. Celles-ci doivent être non ambiguës, ne contenir aucun caractère générique et être complètes, par exemple, C :\Local\Example.doc. Plusieurs noms de fichiers doivent être séparés par des espaces. Un nom de fichier contenant des espaces peut être placé entre guillemets, par exemple , « C :\My File». Dans ce cas, il est traité comme un nom unique. Un signe d’insertion (^) peut également être utilisé comme mécanisme de guillemet pour les caractères uniques, par exemple, C :\My^"File et « C :\My^"File » font référence au fichier C :\My"File.

[in] nType

Spécifie le type d’élément, qui doit être WNTYPE_FILE.

Valeur retournée

Si la fonction réussit, elle retourne WN_SUCCESS. Si la fonction échoue, elle retourne un code d'erreur. Appelez SetLastError pour définir ce code d’erreur étendu, qui peut inclure les codes de retour suivants.

Code de retour Description
WN_BAD_VALUE
Un ou plusieurs paramètres sont une forme ou une valeur inattendue.
WN_OUT_OF_MEMORY
La mémoire est insuffisante pour afficher la boîte de dialogue.
WN_NET_ERROR
Une erreur réseau s’est produite.

Remarques

Cette fonction est appelée uniquement sur les ensembles de propriétés pour lesquels NPGetPropertyText a attribué un nom de bouton.

Cette fonction est utilisée dans le Gestionnaire de fichiers pour afficher et modifier les propriétés réseau (par exemple, les autorisations) des fichiers sur un périphérique réseau. Si cette fonction n’est pas prise en charge, le Gestionnaire de fichiers ne fournit aucun comportement par défaut.

Dans cette version de l’interface du fournisseur de réseau, lpFileName peut pointer uniquement vers des noms de fichiers. Le fournisseur réseau doit retourner WN_BAD_VALUE s’il voit un appareil inapproprié.

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

Voir aussi

NPGetPropertyText

SetLastError