Funzione NetShareDelEx (lmshare.h)

Articolo
03/13/2024

Elimina un nome di condivisione dall'elenco di risorse condivise di un server, che disconnette tutte le connessioni a tale condivisione. Questa funzione, che è una versione estesa della funzione NetShareDel, consente al chiamante di specificare un SHARE_INFO_0, SHARE_INFO_1 , SHARE_INFO_2 , SHARE_INFO_502 o SHARE_INFO_503 struttura.

Sintassi

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

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.

Questa stringa è Unicode se è definita _WIN32_WINNT o FORCE_UNICODE .

[in] level

Specifica il livello di informazioni dei dati. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
0, 1, 2 o 502	Specifica informazioni sulla risorsa condivisa, incluso il nome della risorsa, il tipo e le autorizzazioni e il numero di connessioni. Il parametro buf punta a una struttura SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2 o SHARE_INFO_502 .
503	Specifica informazioni sulla risorsa condivisa, incluso il nome della risorsa, il tipo e le autorizzazioni, il numero di connessioni e altre informazioni pertinenti. Il parametro buf punta a una struttura SHARE_INFO_503 .

[in] buf

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_INTERNAL_ERROR	An internal error occurred.
ERROR_INVALID_LEVEL	Il valore specificato per il parametro di livello non è valido.
ERROR_NOT_SUPPORTED	La richiesta non è supportata.

Commenti

Se viene specificato 503 per il parametro di livello , il parametro buf punta a una struttura SHARE_INFO_503e i shi503_netname e shi503_servername membri di tale struttura vengono usati per cercare la risorsa condivisa nel server; gli altri membri vengono ignorati. Il server remoto specificato nel membro shi503_servername deve essere associato a un protocollo di trasporto usando la funzione NetServerTransportAddEx . Nella chiamata a NetServerTransportAddEx è necessario specificare 2 o 3 per il parametro di livello e il flag di SVTI2_SCOPED_NAME deve essere stato specificato nella struttura SERVER_TRANSPORT_INFO_2 per il protocollo di trasporto.

Se viene specificato 0, 1, 2 o 502 per il parametro di livello, il parametro buf punta a un SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2 o SHARE_INFO_502 struttura e shi0_netname,shi1_netname, shi2_netnameo shi502_netname membro di tale struttura; gli altri membri vengono ignorati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmshare.h (includere Lm.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll