Share via


SetNamespaceFolder method of the MSFT_DfsNamespaceFolder class

Updates the properties of a DFS folder.

Syntax

uint32 SetNamespaceFolder(
  [in]  string                  NamespacePath,
  [in]  string                  Description,
  [in]  uint32                  Flags,
  [in]  uint32                  State,
  [in]  uint32                  TimeToLive,
  [out] MSFT_DfsNamespaceFolder cmdletOutput
);

Parameters

NamespacePath [in]

The Universal Naming Convention (UNC) path of the DFS folder that contains the properties to be updated. The UNC path has a format of \\HostName\SharedName[\ObjectName]*, where:

  • The HostName component represents either the host name of a server or the domain name of a domain that hosts resources.
  • The SharedName component represents the share name or the name of the resource that is being accessed.
  • Each ObjectName component represents the name of a directory on the resource that is being accessed.

Description [in]

A short description to use for the DFS folder.

Flags [in]

A bitwise combination of the enumeration values that represent the new properties of the DFS folder.

InsiteReferrals (1 (0x1))

Enables in-site referrals for the DFS folder.

TargetFailback (8 (0x8))

Enables target failback for the DFS folder.

State [in]

The new state of the DFS folder.

OFFLINE (3)

Not online.

ONLINE (4)

Online.

TimeToLive [in]

The new interval time, in seconds, of the time to live (TTL) of the referral.

cmdletOutput [out]

When this method returns, contains output from the Set-DFSNamespaceFolder cmdlet. This parameter is passed uninitialized.

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2012
Namespace
Root\Microsoft\Windows\dfsn
MOF
DfsNCimProv.mof
DLL
DfsNCimProv.dll

See also

MSFT_DfsNamespaceFolder