Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
As funções de compartilhamento de gerenciamento 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 estã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. |
Estas funções de partilha aplicam-se apenas a partilhas num servidor Server Message Block (LAN Manager). Estas funções de partilha não suportam partilhas DFS (Distributed File System). Por exemplo, a funçãoNetShareGetInfo só pode recuperar informações para um recurso de compartilhamento especificado em um servidor SMB. Para recuperar informações de um compartilhamento usando um provedor de rede diferente (WebDAV ou um compartilhamento DFS, por exemplo), use o função WNetGetConnection.
O 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. NetShareSetInfo suporta o nível de informação SHARE_INFO_1501. Para obter mais informações sobre descritores de segurança, consulte Access Control.
As funções de gerenciamento de rede usam os seguintes nomes de compartilhamento especiais 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 locais seguidos de 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 para listar todas as conexões estabelecidas a partir de um computador específico, chame a funçãoNetConnectionEnum. Você pode chamar NetConnectionEnum nos níveis de CONNECTION_INFO_0 e CONNECTION_INFO_1 informações.
As funções de compartilhamento estão disponíveis nos seguintes níveis de informação, embora alguns níveis de compartilhamento sejam aplicáveis apenas a algumas das funções de compartilhamento:
- SHARE_INFO_0
- SHARE_INFO_1
- SHARE_INFO_2
- SHARE_INFO_501
- SHARE_INFO_502
- SHARE_INFO_503
- SHARE_INFO_1004
- SHARE_INFO_1005
- SHARE_INFO_1006
- SHARE_INFO_1501
Consulte a documentação para obter uma função de compartilhamento específica para obter detalhes.
Se você estiver programando para o Ative Directory, poderá chamar determinados métodos ADSI (Ative 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.