Funzione NetUseAdd (lmuse.h)

Articolo
03/14/2023

La funzione NetUseAdd stabilisce una connessione tra il computer locale e un server remoto. È possibile specificare una lettera di unità locale o un dispositivo stampante per la connessione. Se non si specifica una lettera di unità locale o un dispositivo stampante, la funzione autentica il client con il server per le connessioni future.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetUseAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   LevelFlags,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Parametri

[in] servername

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

Valore che specifica il livello di informazioni dei dati. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
1	Specifica informazioni sulla connessione tra un dispositivo locale e una risorsa condivisa. Le informazioni includono lo stato e il tipo di connessione. Il parametro Buf è 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 e il tipo di connessione e un nome utente e un nome di dominio. Il parametro Buf è un puntatore a una struttura USE_INFO_2 .

[in] buf

Puntatore al buffer che specifica i dati. Il formato di questi dati dipende dal valore del parametro Level . Per altre informazioni, vedere Buffer delle funzioni di gestione di rete.

[out] parm_err

Puntatore a un valore che riceve l'indice del primo membro della struttura delle informazioni in errore quando viene restituito l'errore ERROR_INVALID_PARAMETER. Se questo parametro è NULL, l'indice non viene restituito in caso di errore. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

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

È anche possibile usare le funzioni WNetAddConnection2 e WNetAddConnection3 per reindirizzare un dispositivo locale a una risorsa di rete.

Non è necessaria alcuna appartenenza a gruppi speciali per chiamare la funzione NetUseAdd . Questa funzione non può essere eseguita in un server remoto, ad eccezione dei casi di compatibilità di livello inferiore.

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

Se la funzione NetUseAdd restituisce ERROR_INVALID_PARAMETER, è possibile utilizzare il parametro ParmError per indicare il primo membro della struttura delle informazioni non valida. La struttura delle informazioni inizia con USE_INFO_ e il relativo formato viene specificato dal parametro Level . Nella tabella seguente sono elencati i valori che è possibile restituire nel parametro ParmError e nel membro della struttura corrispondente che si trova in errore. Il prefisso ui*_ indica che il membro può iniziare con più prefissi, ad esempio ui1_ o ui2_.

Costante	Valore	Membro
USE_LOCAL_PARMNUM	1	ui*_local
USE_REMOTE_PARMNUM	2	ui*_remote
USE_PASSWORD_PARMNUM	3	ui*_password
USE_ASGTYPE_PARMNUM	4	ui*_asg_type
USE_USERNAME_PARMNUM	5	ui*_username
USE_DOMAINNAME_PARMNUM	6	ui*_domainname

Requisiti

Requisito	Valore
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