Funzione NetUseGetInfo (lmuse.h)

Articolo
03/14/2023

La funzione NetUseGetInfo recupera informazioni su una connessione a una risorsa condivisa.

È anche possibile usare la funzione WNetGetConnection per recuperare il nome di una risorsa di rete associata a un dispositivo locale.

Sintassi

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

Parametri

[in] UncServerName

Nome UNC del computer in cui eseguire questa funzione. Se questo parametro è NULL, viene usato il computer locale. Se il parametro UncServerName specificato è un computer remoto, il computer remoto deve supportare le chiamate RPC remote usando il meccanismo legacy remote Access Protocol.

Questa stringa è Unicode se sono definite _WIN32_WINNT o FORCE_UNICODE .

[in] UseName

Puntatore a una stringa che specifica il nome della connessione per cui restituire informazioni.

Questa stringa è Unicode se sono definite _WIN32_WINNT o FORCE_UNICODE .

[in] LevelFlags

Livello informativo dei dati richiesti. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
0	Specifica un nome di dispositivo locale e il nome della condivisione di una risorsa remota. Il parametro BufPtr è un puntatore a una struttura USE_INFO_0 .
1	Specifica informazioni sulla connessione tra un dispositivo locale e una risorsa condivisa, inclusi lo stato e il tipo di connessione. Il parametro BufPtr è un puntatore a una struttura USE_INFO_1 .
2	Specifica informazioni sulla connessione tra un dispositivo locale e una risorsa condivisa. Le informazioni includono lo stato della connessione, il tipo di connessione, il nome utente e il nome di dominio. Il parametro BufPtr è un puntatore a una struttura USE_INFO_2 .

[out] bufptr

Puntatore al buffer che riceve i dati. Il formato di questi dati dipende dal valore del parametro Level . Questo buffer viene allocato dal sistema e deve essere liberato usando la funzione NetApiBufferFree . Per altre informazioni, vedere Buffer delle funzioni di gestione di rete e lunghezze del buffer delle funzioni di gestione di rete.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NERR_Success.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema. Per un elenco dei codici di errore, vedere Codici errore di sistema.

Commenti

Non è necessaria alcuna appartenenza speciale al gruppo per chiamare la funzione NetUseGetInfo . Questa funzione non può essere eseguita in un server remoto, ad eccezione dei casi di compatibilità di livello inferiore.

Per elencare tutte le connessioni correnti tra il computer locale e le risorse nei server remoti, è possibile chiamare la funzione NetUseEnum .

Questa funzione si applica solo al client Server Message Block (LAN Manager Workstation). La funzione NetUseGetInfo non supporta le condivisioni DFS (Distributed File System). Per recuperare informazioni per una condivisione usando un provider di rete diverso (WebDAV o una condivisione DFS, ad esempio), usare la funzione WNetGetConnection .

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmuse.h (include Lm.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll