NPSearchDialog-Funktion (npapi.h)

Artikel
03/04/2024

Ermöglicht Netzwerkanbietern die Bereitstellung ihrer eigenen Form des Durchsuchens und Suchens über die hierarchische Ansicht im Dialogfeld Verbindung hinaus. Wenn ein Netzwerkanbieter diese Funktion unterstützt, aktiviert das Dialogfeld Verbindung die Schaltfläche Suchen , wenn das ausgewählte Element zu diesem Anbieter gehört. Wenn der Benutzer auf die Schaltfläche Suchen klickt, ruft das Dialogfeld VerbindungNPSearchDialog auf, um die Benutzeranforderung zu behandeln.

Syntax

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

Parameter

[in] hwndParent

Handle des Fensters, das als übergeordnetes Fenster des Dialogfelds verwendet werden soll.

[in] lpNetResource

Zeiger auf das aktuell ausgewählte Element im Dialogfeld Netzwerk Connections. Ein Anbieter kann dieses Feld ignorieren.

[out] lpBuffer

Zeiger auf einen Puffer, der das Ergebnis der Suche empfängt.

[out] cbBuffer

DWORD , das die Größe des übergebenen Puffers angibt.

[in] lpnFlags

Zeiger auf ein DWORD mit Flags, die der Anbieter festlegen kann, um bestimmte Aktionen zu erzwingen, nachdem das Dialogfeld geschlossen wurde. Das einzige unterstützte Flag ist WNSRCH_REFRESH_FIRST_LEVEL, wodurch MPR gezwungen wird, die erste Ebene unterhalb dieses Anbieters zu reduzieren und dann zu erweitern und zu aktualisieren, nachdem das Dialogfeld geschlossen wurde.

Rückgabewert

Wenn die Funktion erfolgreich ist und der Benutzer auf OK geklickt hat, sollte NPSearchDialog WN_SUCCESS zurückgeben. Andernfalls sollte ein Fehlerwert zurückgegeben werden, der einer der folgenden sein kann. Alle anderen Fehler sollten direkt vom Dialogfeld des Anbieters behandelt oder gemeldet werden.

Rückgabecode	Beschreibung
WN_CANCEL	Der Benutzer hat den Vorgang abgebrochen.
WN_MORE_DATA	Der Eingabepuffer ist zu klein.

Hinweise

Wenn der Anbieter keine Enumeration unterstützt, besteht die Aktion, die dem Doppelklicken auf den Eintrag des Anbieters zugeordnet ist, darin, das Dialogfeld Suchen aufzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	npapi.h

Freigeben über