Função NetShareDelEx (lmshare.h)

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.

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

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

Confira também

NetServerTransportAddEx

NetShareAdd

NetShareDel

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede

Funções de compartilhamento de rede

SHARE_INFO_0

SHARE_INFO_1

SHARE_INFO_2

SHARE_INFO_502

SHARE_INFO_503