Funções de compartilhamento de rede
As funções de compartilhamento de rede controlam os recursos compartilhados. Um recurso compartilhado é um recurso local em um servidor (por exemplo, um diretório de disco, dispositivo de impressão ou pipe nomeado) que pode ser acessado por usuários e aplicativos na rede.
As funções de compartilhamento são listadas a seguir.
| Função | Descrição |
|---|---|
| NetShareAdd | Compartilha um recurso em um servidor. |
| NetShareCheck | Consulta se um servidor está compartilhando um dispositivo. |
| NetShareDel | Exclui um nome de compartilhamento da lista de recursos compartilhados de um servidor. |
| NetShareEnum | Recupera informações de compartilhamento sobre cada recurso compartilhado em um servidor. |
| NetShareGetInfo | Recupera informações sobre um recurso compartilhado especificado em um servidor. |
| Netsharesetinfo | Define os parâmetros de um recurso compartilhado. |
A função NetShareAdd permite que um usuário ou aplicativo compartilhe um recurso de um tipo específico usando o nome de compartilhamento especificado. A função NetShareAdd requer o nome do compartilhamento e o nome do dispositivo local para compartilhar o recurso. Um usuário ou aplicativo deve ter uma conta no servidor para acessar o recurso.
Você também pode especificar um descritor de segurança a ser associado a um compartilhamento. Os descritores de segurança especificam quais usuários têm permissão para acessar arquivos por meio do compartilhamento e com que tipo de acesso. Especifique um SECURITY_DESCRIPTOR com o nível de informações SHARE_INFO_502 ao chamar NetShareAdd ou NetShareSetInfo. O NetShareSetInfo dá suporte ao nível de informações do SHARE_INFO_1501 . Para obter mais informações sobre descritores de segurança, consulte Controle de Acesso.
As funções de gerenciamento de rede usam os seguintes nomes especiais de compartilhamento para comunicação entre processos (IPC) e administração remota do servidor:
- IPC$, reservado para comunicação entre processos
- ADMIN$, reservado para administração remota
- A$, B$, C$ (e outros nomes de disco local seguidos por um cifrão), atribuídos a dispositivos de disco locais
Para listar todas as conexões feitas a um recurso compartilhado em um servidor ou listar todas as conexões estabelecidas de um computador específico, chame a função NetConnectionEnum . Você pode chamar NetConnectionEnum nos níveis de informações CONNECTION_INFO_0 e CONNECTION_INFO_1 .
As funções de compartilhamento estão disponíveis nos seguintes níveis de informações:
Os seguintes níveis de informações são válidos apenas para NetShareSetInfo:
Se você estiver programando para o Active Directory, poderá chamar determinados métodos ADSI (Active Directory Service Interface) para obter a mesma funcionalidade que você pode obter chamando as funções de compartilhamento de gerenciamento de rede. Para obter mais informações, consulte IADsFileShare.