Função NetUseGetInfo (lmuse.h)

Artigo
08/24/2023

A função NetUseGetInfo recupera informações sobre uma conexão com um recurso compartilhado.

Você também pode usar a função WNetGetConnection para recuperar o nome de um recurso de rede associado a um dispositivo local.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetUseGetInfo(
  [in]  LMSTR  UncServerName,
  [in]  LMSTR  UseName,
  [in]  DWORD  LevelFlags,
  [out] LPBYTE *bufptr
);

Parâmetros

[in] UncServerName

O nome UNC do computador no qual executar essa função. Se esse parâmetro for NULL, o computador local será usado. Se o parâmetro UncServerName especificado for um computador remoto, o computador remoto deverá dar suporte a chamadas RPC remotas usando o mecanismo herdado do Protocolo de Acesso Remoto.

Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiverem definidos.

[in] UseName

Um ponteiro para uma cadeia de caracteres que especifica o nome da conexão para a qual retornar informações.

Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiverem definidos.

[in] LevelFlags

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

Valor	Significado
0	Especifica um nome de dispositivo local e o nome do compartilhamento de um recurso remoto. O parâmetro BufPtr é um ponteiro para uma estrutura USE_INFO_0 .
1	Especifica informações sobre a conexão entre um dispositivo local e um recurso compartilhado, incluindo status de conexão e tipo. O parâmetro BufPtr é um ponteiro para uma estrutura USE_INFO_1 .
2	Especifica informações sobre a conexão entre um dispositivo local e um recurso compartilhado. As informações incluem a status de conexão, o tipo de conexão, o nome de usuário e o nome de domínio. O parâmetro BufPtr é um ponteiro para uma estrutura USE_INFO_2 .

[out] bufptr

Um ponteiro para o buffer que recebe os dados. O formato desses dados depende do valor do parâmetro Level . 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 será um código de erro do sistema. Para obter uma lista de códigos de erro, consulte Códigos de erro do sistema.

Comentários

Nenhuma associação de grupo especial é necessária para chamar a função NetUseGetInfo . Essa função não pode ser executada em um servidor remoto, exceto em casos de compatibilidade de nível inferior.

Para listar todas as conexões atuais entre o computador local e os recursos em servidores remotos, você pode chamar a função NetUseEnum .

Essa função se aplica somente ao cliente do Bloco de Mensagens do Servidor (Estação de Trabalho do LAN Manager). A função NetUseGetInfo não dá suporte a compartilhamentos DFS (Sistema de Arquivos Distribuído). Para recuperar informações para um compartilhamento usando um provedor de rede diferente (WebDAV ou um compartilhamento DFS, por exemplo), use a função WNetGetConnection .

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	lmuse.h (inclua Lm.h)
Biblioteca	Netapi32.lib
DLL	Netapi32.dll