Oharra
Baimena behar duzu orria atzitzeko. Direktorioetan saioa has dezakezu edo haiek alda ditzakezu.
Baimena behar duzu orria atzitzeko. Direktorioak alda ditzakezu.
Elimina un nombre de recurso compartido de la lista de recursos compartidos de un servidor, que desconecta todas las conexiones a ese recurso compartido. Esta función, que es una versión extendida de la función NetShareDel , permite al autor de la llamada especificar una estructura de SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2, SHARE_INFO_502 o SHARE_INFO_503 .
Sintaxis
NET_API_STATUS NET_API_FUNCTION NetShareDelEx(
[in] LMSTR servername,
[in] DWORD level,
[in] LPBYTE buf
);
Parámetros
[in] servername
Puntero a una cadena que especifica el nombre DNS o NetBIOS del servidor remoto en el que se va a ejecutar la función. Si este parámetro es NULL, se usa el equipo local.
Esta cadena es Unicode si se define _WIN32_WINNT o FORCE_UNICODE .
[in] level
Especifica el nivel de información de los datos. Este parámetro puede ser uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
Especifica información sobre el recurso compartido, incluido el nombre del recurso, el tipo y los permisos, y el número de conexiones. El parámetro buf apunta a una estructura SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2 o SHARE_INFO_502 . |
|
Especifica información sobre el recurso compartido, incluido el nombre del recurso, el tipo y los permisos, el número de conexiones y otra información pertinente. El parámetro buf apunta a una estructura SHARE_INFO_503 . |
[in] buf
Puntero al búfer que especifica los datos. El formato de estos datos depende del valor del parámetro level . Para obtener más información, consulte Búferes de funciones de administración de red.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NERR_Success.
Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.
| Código devuelto | Descripción |
|---|---|
|
Se ha producido un error interno. |
|
El valor especificado para el parámetro level no es válido. |
|
No se admite la solicitud. |
Comentarios
Si se especifica 503 para el parámetro level , el parámetro buf apunta a una estructura de SHARE_INFO_503 y los shi503_netname y shi503_servername miembros de esa estructura se usan para buscar el recurso compartido en el servidor; se omiten los demás miembros. El servidor remoto especificado en el miembro shi503_servername debe haberse enlazado a un protocolo de transporte mediante la función NetServerTransportAddEx . En la llamada a NetServerTransportAddEx, se debe haber especificado 2 o 3 para el parámetro level y la marca SVTI2_SCOPED_NAME debe haberse especificado en la estructura SERVER_TRANSPORT_INFO_2 para el protocolo de transporte.
Si se especifica 0, 1, 2 o 502 para el parámetro level , el parámetro buf apunta a un SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2 o estructura de SHARE_INFO_502 , y se utiliza el shi0_netname, shi1_netname, shi2_netname o shi502_netname miembro de esa estructura; se omiten los demás miembros.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | lmshare.h (include Lm.h) |
| Library | Netapi32.lib |
| Archivo DLL | Netapi32.dll |
Consulte también
Funciones de administración de redes
Introducción a la administración de redes