FONCTION NPPropertyDialog (npapi.h)

Article
08/25/2023

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

Partager via