Función NPSearchDialog (npapi.h)

Permite a los proveedores de red proporcionar su propia forma de exploración y búsqueda, más allá de la vista jerárquica presentada en el cuadro de diálogo Conexión . Si un proveedor de red admite esta función, el cuadro de diálogo Conexión habilitará el botón Buscar cuando el elemento seleccionado pertenezca a ese proveedor. Si el usuario alcanza el botón Buscar , el cuadro de diálogo Conexión llama a NPSearchDialog para controlar la solicitud del usuario.

Sintaxis

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

Parámetros

[in] hwndParent

Identificador de la ventana que se va a usar como ventana primaria del cuadro de diálogo.

[in] lpNetResource

Puntero al elemento seleccionado actualmente en el cuadro de diálogo Connections de red. Un proveedor puede optar por omitir este campo.

[out] lpBuffer

Puntero a un búfer que recibirá el resultado de la búsqueda.

[out] cbBuffer

DWORD que especificará el tamaño del búfer pasado.

[in] lpnFlags

Puntero a una DWORD de marcas que el proveedor puede establecer para forzar determinadas acciones después de descartar el cuadro de diálogo. La única marca admitida es WNSRCH_REFRESH_FIRST_LEVEL, lo que obliga a MPR a contraerse y, a continuación, expandir y actualizar el primer nivel por debajo de este proveedor después de descartar el cuadro de diálogo.

Valor devuelto

Si la función se ejecuta correctamente y el usuario ha realizado clic en Aceptar, NPSearchDialog debe devolver WN_SUCCESS. De lo contrario, debe devolver un valor de error, que puede ser uno de los siguientes. El cuadro de diálogo del proveedor debe controlar o notificar directamente todos los demás errores.

Código devuelto	Descripción
WN_CANCEL	El usuario canceló la operación.
WN_MORE_DATA	El búfer de entrada es demasiado pequeño.

Comentarios

Si el proveedor no admite la enumeración, la acción asociada al doble clic en la entrada del proveedor será invocar su cuadro de diálogo Buscar .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	npapi.h