Funzione NetServerTransportAdd (lmserver.h)

Articolo
03/14/2023

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