Função NPSearchDialog (npapi.h)

Permite que os fornecedores de rede forneçam sua própria forma de navegação e pesquisa, além da exibição hierárquica apresentada na caixa de diálogo Conexão . Se um provedor de rede der suporte a essa função, a caixa de diálogo Conexão habilitará o botão Pesquisar quando o item selecionado pertence a esse provedor. Se o usuário acessar o botão Pesquisar , a caixa de diálogo Conexão chamará NPSearchDialog para lidar com a solicitação do usuário.

Sintaxe

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

Parâmetros

[in] hwndParent

Identificador da janela a ser usada como a janela pai da caixa de diálogo.

[in] lpNetResource

Ponteiro para o item selecionado no momento na caixa de diálogo Connections rede. Um provedor pode optar por ignorar esse campo.

[out] lpBuffer

Ponteiro para um buffer que receberá o resultado da pesquisa.

[out] cbBuffer

DWORD que especificará o tamanho do buffer passado.

[in] lpnFlags

Ponteiro para um DWORD de sinalizadores que o provedor pode definir para forçar determinadas ações depois que a caixa de diálogo é ignorada. O único sinalizador com suporte é WNSRCH_REFRESH_FIRST_LEVEL, o que força o MPR a recolher e, em seguida, expandir e atualizar o primeiro nível abaixo desse provedor depois que a caixa de diálogo for descartada.

Retornar valor

Se a função for bem-sucedida e o usuário tiver clicado em OK, o NPSearchDialog deverá retornar WN_SUCCESS. Caso contrário, ele deverá retornar um valor de erro, que pode ser um dos seguintes. Todos os outros erros devem ser tratados ou relatados diretamente pela caixa de diálogo do provedor.

Código de retorno	Descrição
WN_CANCEL	O usuário cancelou a operação.
WN_MORE_DATA	O buffer de entrada é muito pequeno.

Comentários

Se o provedor não der suporte à enumeração, a ação associada ao clique duplo na entrada do provedor será invocar sua caixa de diálogo Pesquisar .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	npapi.h