Funzione NetUseAdd (lmuse.h)

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.

[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_.

Requisiti

Vedi anche

NetUseDel

Funzioni di gestione di rete

Panoramica della gestione della rete

USE_INFO_1

USE_INFO_2

Usare funzioni

WNetAddConnection2

WNetAddConnection3