2.3.3.1.1 DFSNamespaceElementBLOB
A DFSNamespaceElementBLOB contains information about a DFS root or a DFS link, or for mapping a server to its site name.
The DFS metadata of a valid DFS namespace MUST consist of one DFSNamespaceRootBLOB for the DFS root and one DFSNamespaceLinkBLOB for each DFS link in the DFS namespace. There MUST no more than one SiteInformationBLOB. For more information on SiteInformationBLOB, see section 2.3.3.1.1.4.
No alignment padding requirements exist for any of a BLOB's fields, unless otherwise specified.
Each DFSNamespaceElementBLOB contains the following data elements. The first three fields are standard for all DFSNamespaceElementBLOB structures. Following those fields are additional fields that are specific to the type of DFSNamespaceElementBLOB, in the format of a DFSNamespaceRootBLOB, a DFSNamespaceLinkBLOB, or a SiteInformationBLOB.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BLOBNameSize |
BLOBName (variable) |
||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
BLOBDataSize |
|||||||||||||||||||||||||||||||
|
BLOBData (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
BLOBNameSize (2 bytes): The size of the BLOBName, in bytes, stored as an unsigned, 16-bit, little-endian integer.
BLOBName (variable): The name of the DFSNamespaceElementBLOB, stored as a string of Unicode characters.
-
Value
Meaning
SiteInformationBLOB
"\siteroot"
A string of Unicode characters that forms the literal "\siteroot".<11>
DFSNamespaceRootBLOB
"\domainroot"
A string of Unicode characters that forms the literal "\domainroot".
DFSNamespaceLinkBLOB
"\domainroot\<GUIDString>"
A string of Unicode characters that forms the literal "\domainroot\<GUIDString>", where <GUIDString> represents the string form of a GUID, as specified in [RFC4122], section 3. The GUID found in the link's ID BLOB MUST be used to create this.
BLOBDataSize (4 bytes): The length of the BLOB in the BLOBData field, stored as an unsigned, 32-bit, little-endian integer. The value of this field MUST be used to determine the start of the next DFSNamespaceElementBLOB.
BLOBData (variable): Data specific to the type of BLOB described, in the form of a DFSNamespaceRootBLOB, DFSNamespaceLinkBLOB, or SiteInformationBLOB.
The following sections specify the format of the DFSNamespaceRootBLOB, DFSNamespaceLinkBLOB, and SiteInformationBLOB.