Função NetFileEnum (lmshare.h)
Retorna informações sobre alguns ou todos os arquivos abertos em um servidor, dependendo dos parâmetros especificados.
Sintaxe
NET_API_STATUS NET_API_FUNCTION NetFileEnum(
[in] LMSTR servername,
[in] LMSTR basepath,
[in] LMSTR username,
[in] DWORD level,
[out] LPBYTE *bufptr,
[in] DWORD prefmaxlen,
[out] LPDWORD entriesread,
[out] LPDWORD totalentries,
[in, out] PDWORD_PTR resume_handle
);
Parâmetros
[in] servername
Ponteiro para uma cadeia de caracteres que especifica o nome DNS ou NetBIOS do servidor remoto no qual a função deve ser executada. Se esse parâmetro for NULL, o computador local será usado.
Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiver definido.
[in] basepath
Ponteiro para uma cadeia de caracteres que especifica um qualificador para as informações retornadas. Se esse parâmetro for NULL, todos os recursos abertos serão enumerados. Se esse parâmetro não for NULL, a função enumera apenas os recursos que têm o valor do parâmetro basepath como um prefixo. (Um prefixo é a parte de um caminho que vem antes de uma barra invertida.)
Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiver definido.
[in] username
Ponteiro para uma cadeia de caracteres que especifica o nome do usuário ou o nome da conexão. Se a cadeia de caracteres começar com duas barras invertidas ("\"), ela indicará o nome da conexão, por exemplo, "\127.0.0.1" ou "\ClientName". A parte do nome da conexão após as barras invertidas é a mesma que o nome do cliente na estrutura de informações de sessão retornada pela função NetSessionEnum . Se a cadeia de caracteres não começar com duas barras invertidas, ela indicará o nome do usuário. Se esse parâmetro não for NULL, seu valor servirá como um qualificador para a enumeração. Os arquivos retornados são limitados àqueles que têm nomes de usuário ou nomes de conexão que correspondem ao qualificador. Se esse parâmetro for NULL, nenhum qualificador de nome de usuário será usado.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse parâmetro é um ponteiro para uma cadeia de caracteres que especifica o nome do usuário. Se esse parâmetro não for NULL, seu valor servirá como um qualificador para a enumeração. Os arquivos retornados são limitados àqueles que têm nomes de usuário correspondentes ao qualificador. Se esse parâmetro for NULL, nenhum qualificador de nome de usuário será usado.
Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiver definido.
[in] level
Especifica o nível de informações dos dados. Esse parâmetro pode usar um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Retornar o número de identificação do arquivo. O parâmetro bufptr aponta para uma matriz de estruturas de FILE_INFO_2 . |
|
Retornar informações sobre o arquivo. O parâmetro bufptr aponta para uma matriz de estruturas de FILE_INFO_3 . |
[out] bufptr
Ponteiro para o endereço do buffer que recebe as informações. O formato desses dados depende do valor do parâmetro de nível .
Esse buffer é alocado pelo sistema e deve ser liberado usando a função NetApiBufferFree . Observe que você deve liberar o buffer mesmo que a função falhe com ERROR_MORE_DATA.
[in] prefmaxlen
Especifica o comprimento máximo preferencial dos dados retornados, em bytes. Se você especificar MAX_PREFERRED_LENGTH, a função alocará a quantidade de memória necessária para os dados. Se você especificar outro valor nesse parâmetro, ele poderá restringir o número de bytes retornados pela função. Se o tamanho do buffer for insuficiente para manter todas as entradas, a função retornará ERROR_MORE_DATA. Para obter mais informações, consulte Buffers de função de gerenciamento de rede e Comprimentos de buffer de função de gerenciamento de rede.
[out] entriesread
Ponteiro para um valor que recebe a contagem de elementos realmente enumerados.
[out] totalentries
Ponteiro para um valor que recebe o número total de entradas que poderiam ter sido enumeradas da posição de currículo atual. Observe que os aplicativos devem considerar esse valor apenas como uma dica.
[in, out] resume_handle
Ponteiro para um valor que contém um identificador de currículo que é usado para continuar uma pesquisa de arquivo existente. O identificador deve ser zero na primeira chamada e deixado inalterado para chamadas subsequentes. Se esse parâmetro for NULL, nenhum identificador de retomada será armazenado.
Retornar valor
Se a função for bem-sucedida, o valor retornado será NERR_Success.
Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de erro.
| Código de retorno | Descrição |
|---|---|
|
O usuário não tem acesso às informações solicitadas. |
|
O valor especificado para o parâmetro de nível não é válido. |
|
Mais entradas estão disponíveis. Especifique um buffer grande o suficiente para receber todas as entradas. |
|
Memória insuficiente disponível. |
|
O buffer fornecido é muito pequeno. |
Comentários
Somente membros do grupo local Administradores ou Operadores de Servidor podem executar com êxito a função NetFileEnum .
Você pode chamar a função NetFileGetInfo para recuperar informações sobre uma abertura específica de um recurso de servidor.
Se você estiver programando para o Active Directory, poderá chamar determinados métodos ADSI (Active Directory Service Interface) para obter a mesma funcionalidade que você pode obter chamando NetFileEnum. Para obter mais informações, consulte IADsResource e IADsFileServiceOperations.
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 | lmshare.h (inclua Lm.h) |
| Biblioteca | Netapi32.lib |
| DLL | Netapi32.dll |