Função NetShareDelEx (lmshare.h)

Artigo
03/14/2023

Exclui um nome de compartilhamento da lista de recursos compartilhados de um servidor, que desconecta todas as conexões com esse compartilhamento. Essa função, que é uma versão estendida da função NetShareDel , permite que o chamador especifique uma estrutura SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2, SHARE_INFO_502 ou SHARE_INFO_503 .

Sintaxe

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

Parâmetros

[in] servername

Ponteiro para uma cadeia de caracteres que especifica o nome DNS ou NetBIOS do servidor remoto no qual a função deve ser executada. Se esse parâmetro for NULL, o computador local será usado.

Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiver definido.

[in] level

Especifica o nível de informações dos dados. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
0, 1, 2 ou 502	Especifica informações sobre o recurso compartilhado, incluindo o nome do recurso, o tipo e as permissões e o número de conexões. O parâmetro buf aponta para uma estrutura SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2 ou SHARE_INFO_502 .
503	Especifica informações sobre o recurso compartilhado, incluindo o nome do recurso, o tipo e as permissões, o número de conexões e outras informações pertinentes. O parâmetro buf aponta para uma estrutura de SHARE_INFO_503 .

[in] buf

Ponteiro para o buffer que especifica os dados. O formato desses dados depende do valor do parâmetro de nível . Para obter mais informações, consulte Buffers de função de gerenciamento de rede.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NERR_Success.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de erro.

Código de retorno	Descrição
ERROR_INTERNAL_ERROR	Ocorreu um erro interno.
ERROR_INVALID_LEVEL	O valor especificado para o parâmetro de nível não é válido.
ERROR_NOT_SUPPORTED	A solicitação não terá suporte.

Comentários

Se 503 for especificado para o parâmetro de nível , o parâmetro buf apontará para uma estrutura SHARE_INFO_503 e os membros shi503_netname e shi503_servername dessa estrutura serão usados para pesquisar o recurso compartilhado no servidor; os outros membros são ignorados. O servidor remoto especificado no membro shi503_servername deve ter sido associado a um protocolo de transporte usando a função NetServerTransportAddEx . Na chamada para NetServerTransportAddEx, 2 ou 3 devem ter sido especificados para o parâmetro de nível e o sinalizador SVTI2_SCOPED_NAME deve ter sido especificado na estrutura SERVER_TRANSPORT_INFO_2 para o protocolo de transporte.

Se 0, 1, 2 ou 502 for especificado para o parâmetro de nível , o parâmetro buf apontará para uma estrutura de SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2 ou SHARE_INFO_502 e o shi0_netname, shi1_netname, shi2_netname ou shi502_netname membro dessa estrutura será usado; os outros membros são ignorados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	lmshare.h (inclua Lm.h)
Biblioteca	Netapi32.lib
DLL	Netapi32.dll