Partager via


NetShareDelEx, fonction (lmshare.h)

Supprime un nom de partage de la liste des ressources partagées d’un serveur, ce qui déconnecte toutes les connexions à ce partage. Cette fonction, qui est une version étendue de la fonction NetShareDel , permet à l’appelant de spécifier une structure SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2, SHARE_INFO_502 ou SHARE_INFO_503 .

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetShareDelEx(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE buf
);

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é.

Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE est défini.

[in] level

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

Valeur Signification
0, 1, 2 ou 502
Spécifie des informations sur la ressource partagée, notamment le nom de la ressource, le type et les autorisations et le nombre de connexions. Le paramètre buf pointe vers une structure SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2 ou SHARE_INFO_502 .
503
Spécifie des informations sur la ressource partagée, notamment le nom de la ressource, le type et les autorisations, le nombre de connexions et d’autres informations pertinentes. Le paramètre buf pointe vers une structure SHARE_INFO_503 .

[in] buf

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 de niveau . 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_INTERNAL_ERROR
Une erreur interne s’est produite.
ERROR_INVALID_LEVEL
La valeur spécifiée pour le paramètre de niveau n’est pas valide.
ERROR_NOT_SUPPORTED
La demande n'est pas prise en charge.

Remarques

Si 503 est spécifié pour le paramètre de niveau , le paramètre buf pointe vers une structure SHARE_INFO_503 et les shi503_netname et shi503_servername membres de cette structure sont utilisés pour rechercher la ressource partagée sur le serveur ; les autres membres sont ignorés. Le serveur distant spécifié dans le membre shi503_servername doit avoir été lié à un protocole de transport à l’aide de la fonction NetServerTransportAddEx . Dans l’appel à NetServerTransportAddEx, 2 ou 3 doivent avoir été spécifiés pour le paramètre de niveau , et l’indicateur SVTI2_SCOPED_NAME doit avoir été spécifié dans la structure SERVER_TRANSPORT_INFO_2 pour le protocole de transport.

Si 0, 1, 2 ou 502 est spécifié pour le paramètre de niveau , le paramètre buf pointe vers une structure SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2 ou SHARE_INFO_502 , et le shi0_netname, shi1_netname, shi2_netname ou shi502_netname membre de cette structure est utilisé ; les autres membres sont ignorés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête lmshare.h (inclure Lm.h)
Bibliothèque Netapi32.lib
DLL Netapi32.dll

Voir aussi

NetServerTransportAddEx

NetShareAdd

NetShareDel

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau

Fonctions de partage réseau

SHARE_INFO_0

SHARE_INFO_1

SHARE_INFO_2

SHARE_INFO_502

SHARE_INFO_503