Função NetDfsSetInfo (lmdfs.h)
Define ou modifica informações sobre uma raiz específica do DFS (Sistema de Arquivos Distribuído), destino raiz, link ou destino de link.
Sintaxe
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
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
ou
\\ Domainname\DomDfsname
em que os valores dos nomes são os mesmos descritos anteriormente.
[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. Também pode ser um nome de compartilhamento com um caminho relativo ao compartilhamento. Por exemplo, "share1\mydir1\mydir2". Esse parâmetro é opcional. Para obter mais informações, consulte a seção Comentários.
[in] Level
Especifica o nível de informações dos dados. Esse parâmetro pode usar um dos valores a seguir.
100
Defina o comentário associado à raiz do DFS ou ao link especificado no parâmetro DfsEntryPath . O parâmetro Buffer aponta para uma estrutura DFS_INFO_100 .
101
Defina o estado de armazenamento associado à raiz do DFS ou ao link especificado no parâmetro DfsEntryPath . O parâmetro Buffer aponta para uma estrutura DFS_INFO_101 .
102
Defina o valor de tempo limite associado à raiz do DFS ou ao link especificado no parâmetro DfsEntryPath . O parâmetro Buffer aponta para uma estrutura DFS_INFO_102 .
103
Defina os sinalizadores de propriedade para a raiz do DFS ou link especificado no parâmetro DfsEntryPath . O parâmetro Buffer aponta para uma estrutura DFS_INFO_103 .
104
Defina a classificação e a classe de prioridade de destino para o destino raiz ou o destino de link especificado no parâmetro DfsEntryPath . O parâmetro Buffer aponta para uma estrutura DFS_INFO_104 .
105
Defina as informações de comentário, estado e tempo limite, bem como sinalizadores de propriedade, para a raiz do DFS ou link especificado no parâmetro DfsEntryPath . O parâmetro Buffer aponta para uma estrutura DFS_INFO_105 .
106
Defina o estado de destino e a prioridade para o destino raiz ou o destino de link especificado no parâmetro DfsEntryPath . Essas informações não podem ser definidas para uma raiz ou link de namespace do DFS, somente para um destino raiz ou destino de link. O parâmetro Buffer aponta para uma estrutura DFS_INFO_106 .
107
Defina o comentário, o estado, as informações de tempo limite e os sinalizadores de propriedade para a raiz do DFS ou o link especificado no parâmetro DfsEntryPath . Para links DFS, você também pode definir o descritor de segurança para o ponto de nova análise do link. O parâmetro Buffer aponta para uma estrutura DFS_INFO_107 .
150
Defina o descritor de segurança para o ponto de nova análise de um link do DFS. O parâmetro Buffer aponta para uma estrutura DFS_INFO_150 .
[in] Buffer
Ponteiro para um buffer que especifica os dados. O formato desses dados 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.
Se você especificar os parâmetros ServerName e ShareName , a função NetDfsSetInfo definirá ou modificará informações específicas para esse destino raiz ou destino de link. Se os parâmetros forem NULL, a função definirá ou modificará informações específicas para a raiz do namespace dfs ou o link dfs em vez de um destino raiz dfs específico ou destino de link.
Como apenas um comentário e um tempo limite podem ser definidos para uma raiz ou link do DFS, os parâmetros ServerName e ShareName são ignorados para os níveis de informações 100 e 102. Esses parâmetros são necessários para o nível 101.
Para o nível de informações 101, os valores de estado DFS_VOLUME_STATE_RESYNCHRONIZE e DFS_VOLUME_STATE_STANDBY podem ser definidos da seguinte maneira para uma raiz DFS baseada em domínio específica quando há mais de um destino raiz DFS para o namespace DFS:
O parâmetro DfsEntryPath especifica o namespace DFS baseado em domínio e os parâmetros ServerName e ShareName juntos especificam o destino raiz do DFS no qual a operação set-information deve ser executada.
Exemplos
O exemplo de código a seguir demonstra como associar um comentário a um link dfs usando uma chamada para a função NetDfsSetInfo . O exemplo especifica o nível de informações 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 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 |
Confira também
Funções dfs (sistema de arquivos distribuído)