Função NetDfsSetClientInfo (lmdfs.h)

Artigo
08/24/2023

Modifica informações sobre uma raiz ou link do DFS (Sistema de Arquivos Distribuído) no cache mantido pelo cliente DFS.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetDfsSetClientInfo(
  [in]           LPWSTR DfsEntryPath,
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR ShareName,
  [in]           DWORD  Level,
  [in]           LPBYTE Buffer
);

Parâmetros

[in] DfsEntryPath

Ponteiro para uma cadeia de caracteres que especifica o caminho UNC (Convenção Universal de Nomenclatura) de uma raiz ou link do DFS.

Para um link, a cadeia de caracteres pode estar em uma das duas formas. O primeiro formulário é o seguinte:

\\ Servername\DfsName\link_path

em que ServerName é o nome do servidor de destino raiz que hospeda o namespace dfs autônomo; DfsName é o nome do namespace dfs; e link_path é um link do DFS.

O segundo formulário é o seguinte:

\\ Domainname\DomDfsname\link_path

em que DomainName é o nome do domínio que hospeda o namespace DFS baseado em domínio; DomDfsname é o nome do namespace dfs; e link_path é um link do DFS.

Para uma raiz, a cadeia de caracteres pode estar em uma das duas formas:

\\ Servername\DfsName

\\ Domainname\DomDfsname

em que os valores dos nomes são os mesmos descritos anteriormente.

Este parâmetro é necessário.

[in, optional] ServerName

Ponteiro para uma cadeia de caracteres que especifica o nome do servidor de destino do link dfs. Esse parâmetro é opcional. Para obter mais informações, consulte a seção Comentários.

[in, optional] ShareName

Ponteiro para uma cadeia de caracteres que especifica o nome do compartilhamento de destino do link dfs. Esse parâmetro é opcional. Para obter informações adicionais, consulte a seção Comentários a seguir.

[in] Level

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

101

Defina o status de armazenamento do link dfs local. O parâmetro Buffer aponta para uma estrutura DFS_INFO_101 .

102

Defina o tempo limite do link dfs local. O parâmetro Buffer aponta para uma estrutura DFS_INFO_102 . Para obter mais informações, consulte a seção Comentários a seguir.

[in] Buffer

Ponteiro para um buffer que contém as informações a serem definidas. O formato dessas informações depende do valor do parâmetro Level . Para obter mais informações, consulte Buffers de função de gerenciamento de rede.

Valor retornado

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

Definir o tempo limite como zero pode não excluir imediatamente a cópia em cache local do link dfs, pois os threads podem estar referenciando a entrada.

Como há apenas um tempo limite em um link dfs, os parâmetros ServerName e ShareName são ignorados para o nível 102.

Os bits DFS_STORAGE_STATE_ONLINE e DFS_STORAGE_STATE_OFFLINE serão ignorados. O bit DFS_STORAGE_STATE_ACTIVE só será válido se nenhum arquivo estiver aberto no computador ativo.

Requisitos


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