Funzione NetServerTransportAdd (lmserver.h)

La funzione NetServerTransportAdd associa il server al protocollo di trasporto.

La funzione estesa NetServerTransportAddEx consente all'applicazione chiamante di specificare i livelli di informazioni SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 e SERVER_TRANSPORT_INFO_3.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetServerTransportAdd(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE bufptr
);

Parametri

[in] servername

Puntatore a una stringa che specifica il nome del server remoto in cui eseguire la funzione. Se questo parametro è NULL, viene usato il computer locale.

[in] level

Specifica il livello di informazioni dei dati. Questo parametro può essere il valore seguente.

Valore Significato
0
Specifica informazioni sul protocollo di trasporto, tra cui nome, indirizzo e posizione nella rete. Il parametro bufptr punta a una struttura SERVER_TRANSPORT_INFO_0 .

[in] bufptr

Puntatore al buffer contenente i dati.

Per altre informazioni, vedere Buffer delle funzioni di gestione della rete.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.

Codice restituito Descrizione
ERROR_ACCESS_DENIED
L'utente non ha accesso alle informazioni richieste.
ERROR_DUP_NAME
Esiste un nome duplicato nella rete.
ERROR_INVALID_DOMAINNAME
Impossibile trovare il nome di dominio nella rete.
ERROR_INVALID_LEVEL
Il valore specificato per il parametro di livello non è valido.
ERROR_INVALID_PARAMETER
Un parametro non è valido.

Questo errore viene restituito se il svti0_transportname o svti0_transportaddress membro nella struttura SERVER_TRANSPORT_INFO_0 puntato dal parametro bufptr è NULL. Questo errore viene restituito anche se il membro svti0_transportaddresslength nella struttura SERVER_TRANSPORT_INFO_0 puntato dal parametro bufptr è zero o maggiore di MAX_PATH (definito nel file di intestazione Windef.h).

Questo errore viene restituito anche per altri parametri non validi.

ERROR_NOT_ENOUGH_MEMORY
Memoria insufficiente disponibile.

Commenti

Solo i membri del gruppo locale Administrators o Server Operator possono eseguire correttamente la funzione NetServerTransportAdd .

Se si aggiunge un protocollo di trasporto a un server usando una chiamata alla funzione NetServerTransportAdd , la connessione non rimarrà dopo il riavvio o il riavvio del server.

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 lmserver.h (include Lm.h)
Libreria Netapi32.lib
DLL Netapi32.dll

Vedi anche

NetServerComputerNameAggiungi

NetServerComputerNameDel

NetServerTransportAddEx

NetServerTransportDel

NetServerTransportEnum

Funzioni di gestione della rete

Panoramica sulla gestione della rete

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

SERVER_TRANSPORT_INFO_2

SERVER_TRANSPORT_INFO_3

Funzioni di trasporto server e workstation