NetServerTransportDel, fonction (lmserver.h)

Article
08/24/2023

La fonction NetServerTransportDel dissocie (ou déconnecte) le protocole de transport du serveur. En fait, le serveur ne peut plus communiquer avec les clients à l’aide du protocole de transport spécifié (par exemple, TCP ou XNS).

Syntaxe

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

Paramètres

[in] servername

Pointeur vers une chaîne qui spécifie le nom DNS ou NetBIOS du serveur distant sur lequel la fonction doit s’exécuter. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

[in] level

Spécifie le niveau d’informations des données. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
0	Spécifie des informations sur le protocole de transport, notamment le nom, l’adresse et l’emplacement sur le réseau. Le paramètre bufptr pointe vers une structure SERVER_TRANSPORT_INFO_0 .
1	Spécifie des informations sur le protocole de transport, notamment le nom, l’adresse, l’emplacement réseau et le domaine. Le paramètre bufptr pointe vers une structure SERVER_TRANSPORT_INFO_1 .

[in] bufptr

Pointeur vers la mémoire tampon qui spécifie les données. Le format de ces données dépend de la valeur du paramètre level . Pour plus d’informations, consultez Mémoires tampons de fonction de gestion réseau.

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_ACCESS_DENIED	L’utilisateur n’a pas accès aux informations demandées.
ERROR_INVALID_LEVEL	La valeur spécifiée pour le paramètre level n’est pas valide.
ERROR_INVALID_PARAMETER	Le paramètre spécifié n’est pas valide.
ERROR_NOT_ENOUGH_MEMORY	La mémoire disponible est insuffisante.
NERR_NetNameNotFound	Le nom du partage n’existe pas.

Notes

Seuls les membres du groupe local Administrateurs ou Opérateurs de serveur peuvent exécuter correctement la fonction NetServerTransportDel .

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	lmserver.h (include Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll