Função NetFileGetInfo (lmshare.h)

Artigo
08/24/2023

Recupera informações sobre uma abertura específica de um recurso de servidor.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetFileGetInfo(
  [in]  LMSTR  servername,
  [in]  DWORD  fileid,
  [in]  DWORD  level,
  [out] LPBYTE *bufptr
);

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] fileid

Especifica o identificador de arquivo do recurso aberto para o qual retornar informações. O valor desse parâmetro deve ter sido retornado em uma chamada de enumeração anterior. Para obter mais informações, consulte a seção Comentários a seguir.

[in] level

Especifica o nível de informações dos dados. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
2	Retornar o número de identificação do arquivo. O parâmetro bufptr é um ponteiro para uma estrutura FILE_INFO_2 .
3	Retornar o número de identificação do arquivo e outras informações sobre o arquivo. O parâmetro bufptr é um ponteiro para uma estrutura 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 . 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.

Valor retornado

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
ERROR_ACCESS_DENIED	O usuário não tem acesso às informações solicitadas.
ERROR_FILE_NOT_FOUND	O arquivo não foi encontrado.
ERROR_INVALID_LEVEL	O valor especificado para o parâmetro de nível não é válido.
ERROR_NOT_ENOUGH_MEMORY	Memória insuficiente disponível.
NERR_BufTooSmall	O buffer fornecido é muito pequeno.

Comentários

Somente membros do grupo local Administradores ou Operadores de Servidor podem executar com êxito a função NetFileGetInfo .

Você pode chamar a função NetFileEnum para recuperar informações sobre vários arquivos abertos em um 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 NetFileGetInfo. Para obter mais informações, consulte IADsResource e IADsFileServiceOperations.

Requisitos


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