Función NetDfsSetClientInfo (lmdfs.h)

Artículo
08/24/2023

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

Sintaxis

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

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 servidor de destino del vínculo DFS. Este parámetro es opcional. Para obtener más información, vea la sección Comentarios.

[in, optional] ShareName

Puntero a una cadena que especifica el nombre del recurso compartido de destino del vínculo DFS. Este parámetro es opcional. Para obtener más información, vea la siguiente sección Comentarios.

[in] Level

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

101

Establezca el estado de almacenamiento del vínculo DFS local. El parámetro Buffer apunta a una estructura DFS_INFO_101 .

102

Establezca el tiempo de espera del vínculo DFS local. El parámetro Buffer apunta a una estructura de DFS_INFO_102 . Para obtener más información, vea la sección Comentarios que se muestra más adelante.

[in] Buffer

Puntero a un búfer que contiene la información que se va a establecer. El formato de esta información depende del valor del parámetro Level . Para obtener más información, consulte Búferes de funciones de administración de redes.

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

El autor de la llamada debe tener privilegios de administrador en el servidor DFS. Para obtener más información sobre las funciones de llamada que requieren privilegios de administrador, consulte Ejecución con privilegios especiales.

Establecer el tiempo de espera en cero puede no eliminar inmediatamente la copia almacenada en caché local del vínculo DFS, ya que los subprocesos pueden hacer referencia a la entrada.

Dado que solo hay un tiempo de espera en un vínculo DFS, los parámetros ServerName y ShareName se omiten para el nivel 102.

Se omitirán los bits de DFS_STORAGE_STATE_ONLINE y DFS_STORAGE_STATE_OFFLINE . El bit de DFS_STORAGE_STATE_ACTIVE solo es válido si no hay ningún archivo abierto al equipo activo.

Requisitos


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