Fungsi NetDfsSetInfo (lmdfs.h)

Artikel
08/24/2023

Mengatur atau memodifikasi informasi tentang akar Sistem File Terdistribusi (DFS) tertentu, target akar, tautan, atau target tautan.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetDfsSetInfo(
  [in]           LPWSTR DfsEntryPath,
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR ShareName,
  [in]           DWORD  Level,
  [in]           LPBYTE Buffer
);

Parameter

[in] DfsEntryPath

Penunjuk ke string yang menentukan jalur Universal Naming Convention (UNC) dari akar atau tautan DFS.

Untuk tautan, string dapat berada dalam salah satu dari dua bentuk. Formulir pertama adalah sebagai berikut:

\\ServerName\DfsName\link_path

di mana ServerName adalah nama server target akar yang menghosting namespace DFS yang berdiri sendiri; DfsName adalah nama namespace layanan DFS; dan link_path adalah tautan DFS.

Bentuk kedua adalah sebagai berikut:

\\DomainName\DomDfsname\link_path

di mana DomainName adalah nama domain yang menghosting namespace DFS berbasis domain; DomDfsname adalah nama namespace layanan DFS; dan link_path adalah tautan DFS.

Untuk akar, string dapat berada dalam salah satu dari dua bentuk:

\\ServerName\DfsName

atau

\\DomainName\DomDfsname

di mana nilai nama sama dengan yang dijelaskan sebelumnya.

[in, optional] ServerName

Penunjuk ke string yang menentukan nama server target tautan DFS. Parameter ini bersifat opsional. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[in, optional] ShareName

Penunjuk ke string yang menentukan nama berbagi target tautan DFS. Ini mungkin juga merupakan nama berbagi dengan jalur yang relatif terhadap berbagi. Misalnya, "share1\mydir1\mydir2". Parameter ini bersifat opsional. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[in] Level

Menentukan tingkat informasi data. Parameter ini bisa menjadi salah satu nilai berikut.

100

Atur komentar yang terkait dengan akar atau tautan DFS yang ditentukan dalam parameter DfsEntryPath . Parameter Buffer menunjuk ke struktur DFS_INFO_100 .

101

Atur status penyimpanan yang terkait dengan akar atau tautan DFS yang ditentukan dalam parameter DfsEntryPath . Parameter Buffer menunjuk ke struktur DFS_INFO_101 .

102

Atur nilai batas waktu yang terkait dengan akar DFS atau tautan yang ditentukan dalam parameter DfsEntryPath . Parameter Buffer menunjuk ke struktur DFS_INFO_102 .

103

Atur bendera properti untuk akar DFS atau tautan yang ditentukan dalam parameter DfsEntryPath . Parameter Buffer menunjuk ke struktur DFS_INFO_103 .

104

Tetapkan peringkat prioritas target dan kelas untuk target akar atau target tautan yang ditentukan dalam parameter DfsEntryPath . Parameter Buffer menunjuk ke struktur DFS_INFO_104 .

105

Atur informasi komentar, status, dan waktu habis, serta bendera properti, untuk akar atau tautan DFS yang ditentukan dalam parameter DfsEntryPath . Parameter Buffer menunjuk ke struktur DFS_INFO_105 .

106

Tetapkan status target dan prioritas untuk target akar atau target tautan yang ditentukan dalam parameter DfsEntryPath . Informasi ini tidak dapat diatur untuk akar atau tautan namespace layanan DFS, hanya untuk target akar atau target tautan. Parameter Buffer menunjuk ke struktur DFS_INFO_106 .

107

Atur komentar, status, informasi waktu habis, dan bendera properti untuk akar atau tautan DFS yang ditentukan dalam parameter DfsEntryPath . Untuk tautan DFS, Anda juga dapat mengatur pendeskripsi keamanan untuk titik pemilah ulang tautan. Parameter Buffer menunjuk ke struktur DFS_INFO_107 .

150

Atur pendeskripsi keamanan untuk titik reparse tautan DFS. Parameter Buffer menunjuk ke struktur DFS_INFO_150 .

[in] Buffer

Penunjuk ke buffer yang menentukan data. Format data ini tergantung pada nilai parameter Tingkat . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem. Untuk daftar kode kesalahan, lihat Kode Kesalahan Sistem.

Keterangan

Pemanggil harus memiliki hak istimewa Administrator di server DFS. Untuk informasi selengkapnya tentang fungsi panggilan yang memerlukan hak istimewa administrator, lihat Menjalankan dengan Hak Istimewa.

Jika Anda menentukan parameter ServerName dan ShareName , fungsi NetDfsSetInfo menetapkan atau memodifikasi informasi khusus untuk target akar atau target tautan tersebut. Jika parameter adalah NULL, fungsi menetapkan atau memodifikasi informasi yang khusus untuk akar namespace DFS atau tautan DFS alih-alih target akar DFS atau target tautan tertentu.

Karena hanya satu komentar dan satu waktu habis yang dapat diatur untuk akar atau tautan DFS, parameter ServerName dan ShareName diabaikan untuk tingkat informasi 100 dan 102. Parameter ini diperlukan untuk tingkat 101.

Untuk informasi tingkat 101, nilai status DFS_VOLUME_STATE_RESYNCHRONIZE dan DFS_VOLUME_STATE_STANDBY dapat diatur sebagai berikut untuk akar DFS berbasis domain tertentu ketika ada lebih dari satu target akar DFS untuk namespace layanan DFS:

Parameter DfsEntryPath menentukan namespace layanan DFS berbasis domain, dan parameter ServerName dan ShareName yang diambil bersama-sama menentukan target akar DFS tempat operasi set-information akan dilakukan.

Contoh

Sampel kode berikut menunjukkan cara mengaitkan komentar dengan tautan DFS menggunakan panggilan ke fungsi NetDfsSetInfo . Sampel menentukan tingkat informasi 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;
}

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	lmdfs.h (termasuk LmDfs.h, Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll