Función NetDfsSetInfo (lmdfs.h)
Establece o modifica información sobre una raíz específica del sistema de archivos distribuido (DFS), el destino raíz, el vínculo o el destino de vínculo.
Sintaxis
NET_API_STATUS NET_API_FUNCTION NetDfsSetInfo(
[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
o
\\Nombrededominio\DomDfsname
donde los valores de los nombres son los mismos que los descritos anteriormente.
[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. También puede ser un nombre de recurso compartido con una ruta de acceso relativa al recurso compartido. Por ejemplo, "share1\mydir1\mydir2". Este parámetro es opcional. Para obtener más información, vea la sección Comentarios.
[in] Level
Especifica el nivel de información de los datos. Este parámetro puede ser uno de los valores siguientes.
100
Establezca el comentario asociado a la raíz o vínculo DFS especificado en el parámetro DfsEntryPath . El parámetro Buffer apunta a una estructura de DFS_INFO_100 .
101
Establezca el estado de almacenamiento asociado a la raíz o vínculo DFS especificado en el parámetro DfsEntryPath . El parámetro Buffer apunta a una estructura DFS_INFO_101 .
102
Establezca el valor de tiempo de espera asociado a la raíz o vínculo DFS especificado en el parámetro DfsEntryPath . El parámetro Buffer apunta a una estructura de DFS_INFO_102 .
103
Establezca las marcas de propiedad para la raíz o el vínculo DFS especificados en el parámetro DfsEntryPath . El parámetro Buffer apunta a una estructura DFS_INFO_103 .
104
Establezca la clasificación y la clase de prioridad de destino para el destino raíz o el destino de vínculo especificados en el parámetro DfsEntryPath . El parámetro Buffer apunta a una estructura de DFS_INFO_104 .
105
Establezca la información de comentario, estado y tiempo de espera, así como marcas de propiedad, para la raíz o el vínculo DFS especificado en el parámetro DfsEntryPath . El parámetro Buffer apunta a una estructura DFS_INFO_105 .
106
Establezca el estado de destino y la prioridad para el destino raíz o el destino de vínculo especificados en el parámetro DfsEntryPath . Esta información no se puede establecer para una raíz o vínculo de espacio de nombres DFS, solo para un destino raíz o un destino de vínculo. El parámetro Buffer apunta a una estructura de DFS_INFO_106 .
107
Establezca el comentario, el estado, la información de tiempo de espera y las marcas de propiedad para la raíz o el vínculo DFS especificados en el parámetro DfsEntryPath . En el caso de los vínculos DFS, también puede establecer el descriptor de seguridad para el punto de reanálisis del vínculo. El parámetro Buffer apunta a una estructura de DFS_INFO_107 .
150
Establezca el descriptor de seguridad para el punto de reanálisis de un vínculo DFS. El parámetro Buffer apunta a una estructura de DFS_INFO_150 .
[in] Buffer
Puntero a un búfer que especifica los datos. El formato de estos datos 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 se 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.
Si especifica los parámetros ServerName y ShareName , la función NetDfsSetInfo establece o modifica la información específica de ese destino raíz o destino de vínculo. Si los parámetros son NULL, la función establece o modifica la información específica de la raíz del espacio de nombres DFS o el vínculo DFS en lugar de un destino raíz o destino de vínculo DFS específico.
Dado que solo se puede establecer un comentario y un tiempo de espera para una raíz o vínculo DFS, los parámetros ServerName y ShareName se omiten para los niveles de información 100 y 102. Estos parámetros son necesarios para el nivel 101.
Para el nivel de información 101, los valores de estado de DFS_VOLUME_STATE_RESYNCHRONIZE y DFS_VOLUME_STATE_STANDBY se pueden establecer de la siguiente manera para una raíz DFS específica basada en dominio cuando hay más de un destino raíz DFS para el espacio de nombres DFS:
El parámetro DfsEntryPath especifica el espacio de nombres DFS basado en dominio y los parámetros ServerName y ShareName tomados juntos especifican el destino raíz DFS en el que se va a realizar la operación set-information.
Ejemplos
En el ejemplo de código siguiente se muestra cómo asociar un comentario a un vínculo DFS mediante una llamada a la función NetDfsSetInfo . El ejemplo especifica el nivel de información 100 (DFS_INFO_100).
#include <windows.h>
#include <lm.h>
#include <lmdfs.h>
#include <stdio.h>
#pragma comment(lib, "Netapi32.lib")
void wmain(int argc, wchar_t *argv[])
{
DFS_INFO_100 dfsData;
DWORD res;
//
// Check command line arguments.
//
if (argc<2)
wprintf(L"Syntax: %s DfsEntryPath [\"Comment\"]\n", argv[0]);
else
{
//
// Fill in DFS_INFO_100 structure member.
//
dfsData.Comment = argc < 3 ? NULL : argv[2];
//
// Call the NetDfsSetInfo function, specifying level 100.
//
res = NetDfsSetInfo(argv[1], NULL, NULL, 100, (LPBYTE) &dfsData);
//
// Display the result of the call.
//
if(res == 0)
printf("Comment set.\n");
else
printf("Error: %u", res);
}
return;
}
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 |
Consulte también
Funciones del sistema de archivos distribuido (DFS)