Funzione NetServerTransportDel (lmserver.h)

Articolo
08/24/2023

La funzione NetServerTransportDel unbinds (o disconnette) il protocollo di trasporto dal server. In modo efficace, il server non può più comunicare con i client usando il protocollo di trasporto specificato ,ad esempio TCP o XNS.

Sintassi

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

Parametri

[in] servername

Puntatore a una stringa che specifica il nome DNS o NetBIOS 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ò avere uno dei valori seguenti.

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 .
1	Specifica informazioni sul protocollo di trasporto, tra cui nome, indirizzo, posizione di rete e dominio. Il parametro bufptr punta a una struttura SERVER_TRANSPORT_INFO_1 .

[in] bufptr

Puntatore al buffer che specifica i dati. Il formato di questi dati dipende dal valore del parametro di livello . 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_INVALID_LEVEL	Il valore specificato per il parametro di livello non è valido.
ERROR_INVALID_PARAMETER	Il parametro specificato non è valido.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente disponibile.
NERR_NetNameNotFound	Il nome della condivisione non esiste.

Commenti

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

Requisiti


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