NetShareDelEx, fonction (lmshare.h)

Article
03/14/2023

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