Função NPGetDirectoryType (npapi.h)

Determina o tipo de um diretório de rede. A função NPGetDirectoryType é usada pelo Gerenciador de Arquivos.

Sintaxe

DWORD NPGetDirectoryType(
  [in] LPWSTR lpName,
  [in] LPINT  lpType,
  [in] BOOL   bFlushCache
);

Parâmetros

[in] lpName

Ponteiro para o nome totalmente qualificado do diretório. O provedor de rede retorna o tipo para o endereço apontado por lpType. Se o valor retornado em lpType for zero ou se o provedor de rede retornar um erro, o Gerenciador de Arquivos exibirá o diretório como um diretório "normal".

[in] lpType

Ponteiro para um valor definido pelo provedor de rede. Esse valor é usado para modificar a exibição da árvore de unidade no Gerenciador de Arquivos. Dessa forma, o provedor de rede pode mostrar diretórios especiais para o usuário.

[in] bFlushCache

Defina como TRUE quando o Gerenciador de Arquivos chamar MPR para obter o tipo de diretório pela primeira vez enquanto repintam uma janela em Atualizar. Posteriormente, ele será FALSE. Isso dá a um provedor a oportunidade de otimizar o desempenho se ele quiser apenas ler os dados de uma unidade uma vez e, em seguida, armazená-los em cache até a próxima Atualização.

Retornar valor

Essa função deverá retornar WN_SUCCESS se for bem-sucedida. Caso contrário, ele deverá retornar um código de erro, que pode incluir o seguinte.

Código de retorno Descrição
WN_NOT_SUPPORTED

Não há suporte para NPGetDirectoryType.

Comentários

O Gerenciador de Arquivos fornecerá seu próprio ícone para todos os diretórios de rede especiais; ou seja, quando lpType for definido como um valor diferente de zero, o Gerenciador de Arquivos exibirá um ícone de pasta especial.

A implementação dessa função deve ser de alto desempenho ou rápida, pois a chamada ocorre enquanto o Gerenciador de Arquivos está pintando a árvore de diretório.

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