Funzione NPSearchDialog (npapi.h)

Articolo
02/29/2024

Consente ai fornitori di rete di fornire la propria forma di esplorazione e ricerca, oltre alla visualizzazione gerarchica visualizzata nella finestra di dialogo Connessione . Se un provider di rete supporta questa funzione, la finestra di dialogo Connessione abiliterà il pulsante Cerca quando l'elemento selezionato appartiene a tale provider. Se l'utente raggiunge il pulsante Cerca , la finestra di dialogo Connessione chiama NPSearchDialog per gestire la richiesta dell'utente.

Sintassi

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

Parametri

[in] hwndParent

Handle della finestra da utilizzare come finestra padre della finestra di dialogo.

[in] lpNetResource

Puntatore all'elemento attualmente selezionato nella finestra di dialogo Rete Connections. Un provider può scegliere di ignorare questo campo.

[out] lpBuffer

Puntatore a un buffer che riceverà il risultato della ricerca.

[out] cbBuffer

DWORD che specifica le dimensioni del buffer passato.

[in] lpnFlags

Puntatore a un DWORD di flag che il provider può impostare per forzare determinate azioni dopo che la finestra di dialogo viene chiusa. L'unico flag supportato è WNSRCH_REFRESH_FIRST_LEVEL, che forza MPR a comprimere e quindi espandere e aggiornare il primo livello inferiore a questo provider dopo che la finestra di dialogo viene chiusa.

Valore restituito

Se la funzione ha esito positivo e l'utente ha fatto clic su OK, NPSearchDialog deve restituire WN_SUCCESS. In caso contrario, deve restituire un valore di errore, che può essere uno dei seguenti. Tutti gli altri errori devono essere gestiti o segnalati direttamente dalla finestra di dialogo del provider.

Codice restituito	Descrizione
WN_CANCEL	L'utente ha annullato l'operazione.
WN_MORE_DATA	Il buffer di input è troppo piccolo.

Commenti

Se il provider non supporta l'enumerazione, l'azione associata a un doppio clic sulla voce del provider sarà quella di richiamare la finestra di dialogo Cerca .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	npapi.h