Compartilhar via


Função NetDfsAddStdRoot (lmdfs.h)

Cria um namespace do DFS (Sistema de Arquivos Distribuído) autônomo.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetDfsAddStdRoot(
  [in]           LPWSTR ServerName,
  [in]           LPWSTR RootShare,
  [in, optional] LPWSTR Comment,
  [in]           DWORD  Flags
);

Parâmetros

[in] ServerName

Ponteiro para uma cadeia de caracteres que especifica o nome do servidor que hospedará o novo namespace dfs autônomo. Este parâmetro é necessário.

[in] RootShare

Ponteiro para uma cadeia de caracteres que especifica o nome da pasta compartilhada para o novo namespace dfs autônomo no servidor que hospedará o namespace. Este parâmetro é necessário.

[in, optional] Comment

Ponteiro para uma cadeia de caracteres que contém um comentário opcional associado ao namespace dfs.

[in] Flags

Esse parâmetro é reservado e precisa ser zero.

Retornar valor

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

Se a função falhar, o valor retornado será um código de erro do sistema. Para obter uma lista de códigos de erro, consulte Códigos de erro do sistema.

Comentários

O compartilhamento especificado pelo parâmetro RootShare já deve existir no servidor que hospedará o novo destino raiz do DFS. Essa função não cria um novo compartilhamento.

O chamador deve ter privilégio de Administrador no servidor DFS. Para obter mais informações sobre como chamar funções que exigem privilégios de administrador, consulte Executando com privilégios especiais.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho lmdfs.h (inclua LmDfs.h, Lm.h)
Biblioteca Netapi32.lib
DLL Netapi32.dll

Confira também

Funções dfs (sistema de arquivos distribuído)

NetDfsAddFtRoot

NetDfsAddRootTarget

NetDfsRemoveStdRoot

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede