Función NetDfsGetClientInfo (lmdfs.h)

Artículo
03/14/2023

Recupera información sobre una raíz o vínculo del sistema de archivos distribuido (DFS) de la memoria caché mantenida por el cliente DFS.

Sintaxis

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

Puntero a una cadena que especifica la ruta de acceso de convención de nomenclatura universal (UNC) de una raíz o vínculo DFS.

Para un vínculo, la cadena puede estar en una de las dos formas. El primer formulario es el siguiente:

\\Nombredeservidor\DfsName\link_path

donde ServerName es el nombre del servidor de destino raíz que hospeda el espacio de nombres DFS independiente; DfsName es el nombre del espacio de nombres DFS; y link_path es un vínculo DFS.

El segundo formulario es el siguiente:

\\Nombrededominio\DomDfsname\link_path

donde DomainName es el nombre del dominio que hospeda el espacio de nombres DFS basado en dominio; DomDfsname es el nombre del espacio de nombres DFS; y link_path es un vínculo DFS.

Para una raíz, la cadena puede estar en una de estas dos formas:

\\Nombredeservidor\DfsName

\\Nombrededominio\DomDfsname

donde los valores de los nombres son los mismos que los descritos anteriormente.

Este parámetro es obligatorio.

[in, optional] ServerName

Puntero a una cadena que especifica el nombre del destino raíz DFS o del servidor de destino de vínculo. Este parámetro es opcional.

[in, optional] ShareName

Puntero a una cadena que especifica el nombre del recurso compartido correspondiente al destino raíz o al destino de vínculo DFS. Este parámetro es opcional.

[in] Level

Especifica el nivel de información de la solicitud. Este parámetro puede ser uno de los valores siguientes.

1

Devuelve el nombre del vínculo RAÍZ DFS o DFS. El parámetro Buffer apunta a una estructura de DFS_INFO_1 .

2

Devuelve el nombre, el estado y el nombre del vínculo DFS raíz o DFS y el número de destinos DFS. El parámetro Buffer apunta a una estructura de DFS_INFO_2 .

3

Devuelve la información de nombre, estado y destino del vínculo DFS raíz o DFS. El parámetro Buffer apunta a una estructura de DFS_INFO_3 .

4

Devuelve el nombre del vínculo DFS raíz o DFS, el estado, el GUID, el tiempo de espera y la información de destino. El parámetro Buffer apunta a una estructura de DFS_INFO_4 .

[out] Buffer

Puntero a la dirección de un búfer que recibe la información solicitada. El sistema asigna este búfer y debe liberarse mediante la función NetApiBufferFree . Para obtener más información, consulte Búferes de funciones de administración de red y longitudes de búfer de funciones de administración de red.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NERR_Success.

Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista de códigos de error, consulte Códigos de error del sistema.

Comentarios

No se requiere ninguna pertenencia especial a grupos para usar la función NetDfsGetClientInfo .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	lmdfs.h (incluya LmDfs.h, Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll