NetDfsSetInfo 함수(lmdfs.h)

아티클
08/24/2023

특정 DFS(분산 파일 시스템) 루트, 루트 대상, 링크 또는 링크 대상에 대한 정보를 설정하거나 수정합니다.

구문

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

매개 변수

[in] DfsEntryPath

DFS 루트 또는 링크의 UNC(범용 명명 규칙) 경로를 지정하는 문자열에 대한 포인터입니다.

링크의 경우 문자열은 두 가지 양식 중 하나일 수 있습니다. 첫 번째 양식은 다음과 같습니다.

\\Servername\DfsName\link_path

여기서 ServerName 은 독립 실행형 DFS 네임스페이스를 호스트하는 루트 대상 서버의 이름입니다. DfsName 은 DFS 네임스페이스의 이름입니다. link_path DFS 링크입니다.

두 번째 양식은 다음과 같습니다.

\\Domainname\DomDfsname\link_path

여기서 DomainName 은 도메인 기반 DFS 네임스페이스를 호스트하는 도메인의 이름입니다. DomDfsname 은 DFS 네임스페이스의 이름입니다. link_path DFS 링크입니다.

루트의 경우 문자열은 다음 두 가지 형식 중 하나일 수 있습니다.

\\Servername\DfsName

또는

\\Domainname\DomDfsname

여기서 이름의 값은 앞에서 설명한 값과 동일합니다.

[in, optional] ServerName

DFS 링크 대상 서버 이름을 지정하는 문자열에 대한 포인터입니다. 이 매개 변수는 선택 사항입니다. 자세한 내용은 주의 섹션을 참조하세요.

[in, optional] ShareName

DFS 링크 대상 공유 이름을 지정하는 문자열에 대한 포인터입니다. 공유에 상대적인 경로가 있는 공유 이름일 수도 있습니다. 예를 들어 "share1\mydir1\mydir2"가 있습니다. 이 매개 변수는 선택 사항입니다. 자세한 내용은 주의 섹션을 참조하세요.

[in] Level

데이터의 정보 수준을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

100

DfsEntryPath 매개 변수에 지정된 DFS 루트 또는 링크와 연결된 주석을 설정합니다. Buffer 매개 변수는 DFS_INFO_100 구조를 가리킵니다.

101

DfsEntryPath 매개 변수에 지정된 DFS 루트 또는 링크와 연결된 스토리지 상태를 설정합니다. Buffer 매개 변수는 DFS_INFO_101 구조를 가리킵니다.

102

DfsEntryPath 매개 변수에 지정된 DFS 루트 또는 링크와 연결된 제한 시간 값을 설정합니다. Buffer 매개 변수는 DFS_INFO_102 구조를 가리킵니다.

103

DfsEntryPath 매개 변수에 지정된 DFS 루트 또는 링크에 대한 속성 플래그를 설정합니다. Buffer 매개 변수는 DFS_INFO_103 구조를 가리킵니다.

104

DfsEntryPath 매개 변수에 지정된 루트 대상 또는 링크 대상에 대한 대상 우선 순위 및 클래스를 설정합니다. Buffer 매개 변수는 DFS_INFO_104 구조를 가리킵니다.

105

DfsEntryPath 매개 변수에 지정된 DFS 루트 또는 링크에 대한 주석, 상태 및 시간 제한 정보 및 속성 플래그를 설정합니다. Buffer 매개 변수는 DFS_INFO_105 구조를 가리킵니다.

106

DfsEntryPath 매개 변수에 지정된 루트 대상 또는 링크 대상의 대상 상태 및 우선 순위를 설정합니다. 이 정보는 루트 대상 또는 링크 대상에 대해서만 DFS 네임스페이스 루트 또는 링크에 대해 설정할 수 없습니다. Buffer 매개 변수는 DFS_INFO_106 구조를 가리킵니다.

107

DfsEntryPath 매개 변수에 지정된 DFS 루트 또는 링크에 대한 주석, 상태, 시간 제한 정보 및 속성 플래그를 설정합니다. DFS 링크의 경우 링크의 재분석 지점에 대한 보안 설명자를 설정할 수도 있습니다. Buffer 매개 변수는 DFS_INFO_107 구조를 가리킵니다.

150

DFS 링크의 재분석 지점에 대한 보안 설명자를 설정합니다. Buffer 매개 변수는 DFS_INFO_150 구조를 가리킵니다.

[in] Buffer

데이터를 지정하는 버퍼에 대한 포인터입니다. 이 데이터의 형식은 Level 매개 변수의 값에 따라 달라집니다. 자세한 내용은 네트워크 관리 함수 버퍼를 참조하세요.

반환 값

함수가 성공하면 반환 값이 NERR_Success.

함수가 실패하면 반환 값은 시스템 오류 코드입니다. 오류 코드 목록은 시스템 오류 코드를 참조하세요.

설명

호출자는 DFS 서버에 대한 관리자 권한이 있어야 합니다. 관리자 권한이 필요한 함수를 호출하는 방법에 대한 자세한 내용은 특별 권한으로 실행을 참조하세요.

ServerName 및 ShareName 매개 변수를 모두 지정하는 경우 NetDfsSetInfo 함수는 해당 루트 대상 또는 링크 대상과 관련된 정보를 설정하거나 수정합니다. 매개 변수가 NULL인 경우 함수는 특정 DFS 루트 대상 또는 링크 대상 대신 DFS 네임스페이스 루트 또는 DFS 링크와 관련된 정보를 설정하거나 수정합니다.

DFS 루트 또는 링크에 대해 하나의 주석과 한 번의 시간 제한만 설정할 수 있으므로 정보 수준 100 및 102에서는 ServerName 및 ShareName 매개 변수가 무시됩니다. 이러한 매개 변수는 수준 101에 필요합니다.

정보 수준 101의 경우 DFS 네임스페이스에 대해 둘 이상의 DFS 루트 대상이 있는 경우 특정 도메인 기반 DFS 루트에 대해 다음과 같이 DFS_VOLUME_STATE_RESYNCHRONIZE 및 DFS_VOLUME_STATE_STANDBY 상태 값을 설정할 수 있습니다.

DfsEntryPath 매개 변수는 도메인 기반 DFS 네임스페이스를 지정하고 함께 가져온 ServerName 및 ShareName 매개 변수는 set-information 작업을 수행할 DFS 루트 대상을 지정합니다.

예제

다음 코드 샘플에서는 NetDfsSetInfo 함수에 대한 호출을 사용하여 주석을 DFS 링크와 연결하는 방법을 보여 줍니다. 샘플은 정보 수준 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;
}

요구 사항


지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	lmdfs.h(LmDfs.h, Lm.h 포함)
라이브러리	Netapi32.lib
DLL	Netapi32.dll