Função NetDfsGetClientInfo (lmdfs.h)

Artigo
02/20/2025

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

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetDfsGetClientInfo(
  [in]           LPWSTR DfsEntryPath,
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR ShareName,
  [in]           DWORD  Level,
  [out]          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 destino raiz do DFS ou do servidor de destino do link. Esse parâmetro é opcional.

[in, optional] ShareName

Ponteiro para uma cadeia de caracteres que especifica o nome do compartilhamento correspondente ao destino raiz do DFS ou ao destino do link. Esse parâmetro é opcional.

[in] Level

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

1

Retornar o nome do link dfs raiz ou DFS. O parâmetro Buffer aponta para uma estrutura DFS_INFO_1 .

2

Retornar o nome do link dfs raiz ou DFS, status e o número de destinos DFS. O parâmetro Buffer aponta para uma estrutura DFS_INFO_2 .

3

Retornar o nome do link dfs raiz ou DFS, status e informações de destino. O parâmetro Buffer aponta para uma estrutura DFS_INFO_3 .

4

Retornar o nome do link dfs raiz ou DFS, status, GUID, tempo limite e informações de destino. O parâmetro Buffer aponta para uma estrutura DFS_INFO_4 .

[out] Buffer

Ponteiro para o endereço de um buffer que recebe as informações solicitadas. Esse buffer é alocado pelo sistema e deve ser liberado usando a função NetApiBufferFree . Para obter mais informações, consulte Buffers de função de gerenciamento de rede e Comprimentos de buffer 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 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

Nenhuma associação de grupo especial é necessária para usar a função NetDfsGetClientInfo .

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