NPSearchDialog, fonction (npapi.h)

Article
02/29/2024

Permet aux fournisseurs réseau de fournir leur propre forme de navigation et de recherche, au-delà de la vue hiérarchique présentée dans la boîte de dialogue Connexion . Si un fournisseur de réseau prend en charge cette fonction, la boîte de dialogue Connexion active le bouton Rechercher lorsque l’élément sélectionné appartient à ce fournisseur. Si l’utilisateur appuie sur le bouton Rechercher , la boîte de dialogue Connexion appelle NPSearchDialog pour gérer la demande de l’utilisateur.

Syntaxe

DWORD NPSearchDialog(
  [in]  HWND           hwndParent,
  [in]  LPNETRESOURCEW lpNetResource,
  [out] LPVOID         lpBuffer,
  [out] DWORD          cbBuffer,
  [in]  LPDWORD        lpnFlags
);

Paramètres

[in] hwndParent

Handle de la fenêtre à utiliser comme fenêtre parente de la boîte de dialogue.

[in] lpNetResource

Pointeur vers l’élément actuellement sélectionné dans la boîte de dialogue Connections réseau. Un fournisseur peut choisir d’ignorer ce champ.

[out] lpBuffer

Pointeur vers une mémoire tampon qui recevra le résultat de la recherche.

[out] cbBuffer

DWORD qui spécifie la taille de la mémoire tampon passée.

[in] lpnFlags

Pointeur vers un DWORD d’indicateurs que le fournisseur peut définir pour forcer certaines actions une fois la boîte de dialogue ignorée. Le seul indicateur pris en charge est WNSRCH_REFRESH_FIRST_LEVEL, ce qui force MPR à s’effondrer, puis à développer et actualiser le premier niveau sous ce fournisseur une fois la boîte de dialogue ignorée.

Valeur retournée

Si la fonction réussit et que l’utilisateur a cliqué sur OK, NPSearchDialog doit retourner WN_SUCCESS. Sinon, il doit retourner une valeur d’erreur, qui peut être l’une des suivantes. Toutes les autres erreurs doivent être gérées ou signalées directement par la boîte de dialogue du fournisseur.

Code de retour	Description
WN_CANCEL	L’utilisateur a annulé l’opération.
WN_MORE_DATA	La mémoire tampon d’entrée est trop petite.

Remarques

Si le fournisseur ne prend pas en charge l’énumération, l’action associée au double-clic sur l’entrée du fournisseur consiste à appeler sa boîte de dialogue Recherche .

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