Função NPPropertyDialog (npapi.h)

  • Artigo

Chamado quando o usuário clica em um botão adicionado usando a função NPPropertyDialog . A função NPPropertyDialog é chamada apenas para propriedades de rede de arquivo e diretório.

Sintaxe

DWORD NPPropertyDialog(
  [in] HWND   hwndParent,
  [in] DWORD  iButtonDlg,
  [in] DWORD  nPropSel,
  [in] LPWSTR lpFileName,
  [in] DWORD  nType
);

Parâmetros

[in] hwndParent

Um identificador para a janela pai que deve possuir a caixa de diálogo de propriedade do arquivo.

[in] iButtonDlg

O índice do botão que foi pressionado.

Esse índice especifica qual caixa de diálogo de propriedade foi solicitada, começando com uma para o primeiro botão retornado da função NPGetPropertyText . Se houver vários nomes de arquivo selecionados, 10 serão adicionados a esse número. Em outras palavras, se houver mais de um arquivo selecionado e o usuário pressionar o primeiro botão de propriedade definido pelo provedor, iButtonDlg será 11. Se houver apenas um arquivo selecionado e o usuário pressionar o segundo botão de propriedade de rede, iButtonDlg será dois.

[in] nPropSel

Especifica em quais itens a caixa de diálogo de propriedade deve agir. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
WNPS_FILE
 Um único arquivo.
WNPS_DIR
 Um único diretório.
WNPS_MULT
 Uma seleção de vários arquivos, diretórios ou ambos.

[in] lpFileName

Um ponteiro para os nomes dos itens nos quais a caixa de diálogo de propriedade deve agir. Os únicos itens com suporte são arquivos e diretórios, portanto, os nomes dos itens são nomes de arquivo. Elas devem ser inequívocas, não conter caracteres curinga e ser totalmente qualificadas, por exemplo, C:\Local\Example.doc. Vários nomes de arquivo devem ser separados com espaços. Um nome de arquivo que contém espaços pode ser colocado entre aspas, por exemplo, "C:\Meu Arquivo". Nesse caso, ele é tratado como um único nome. Um cursor (^) também pode ser usado como o mecanismo de aspas para caracteres únicos, por exemplo, C:\My^"File e "C:\My^"File" referem-se ao arquivo C:\My"File.

[in] nType

Especifica o tipo de item, que deve ser WNTYPE_FILE.

Retornar valor

Se a função for bem-sucedida, ela retornará WN_SUCCESS. Se a função falhar, será exibido um código de erro. Chame SetLastError para definir esse código de erro estendido, que pode incluir os seguintes códigos de retorno.

Código de retorno Descrição
WN_BAD_VALUE
 Um ou mais parâmetros é um formulário ou valor inesperado.
WN_OUT_OF_MEMORY
 Não há memória suficiente para exibir a caixa de diálogo.
WN_NET_ERROR
 Ocorreu um erro de rede.

Comentários

Essa função é chamada apenas em conjuntos de propriedades para os quais NPGetPropertyText atribuiu um nome de botão.

Essa função é usada no Gerenciador de Arquivos para exibir e modificar as propriedades de rede (por exemplo, permissões) para arquivos em um dispositivo de rede. Se essa função não tiver suporte, o Gerenciador de Arquivos não fornecerá nenhum comportamento padrão.

Nesta versão da interface do Provedor de Rede, lpFileName pode apontar apenas para nomes de arquivo. O provedor de rede deverá retornar WN_BAD_VALUE se vir um dispositivo inadequado.

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

Confira também

NPGetPropertyText

SetLastError