MSFT_SmbOpenFile class
Represents a file that is opened on an SMB server from the server's perspective.
The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.
Syntax
class MSFT_SmbOpenFile
{
uint64 FileId;
uint64 SessionId;
string ScopeName;
string ClusterNodeName;
string Path;
string ShareRelativePath;
string ClientComputerName;
string ClientUserName;
uint32 Permissions;
uint32 Locks;
boolean ContinuouslyAvailable;
boolean Encrypted;
};
Members
The MSFT_SmbOpenFile class has these types of members:
Methods
The MSFT_SmbOpenFile class has these methods.
| Method | Description |
|---|---|
| ForceClose |
Forcibly closes a file that is open on behalf of an SMB client. Unsaved data might be lost. |
Properties
The MSFT_SmbOpenFile class has these properties.
- ClientComputerName
-
- Data type: string
- Access type: Read-only
The name of the computer from which the file handle was opened.
- ClientUserName
-
- Data type: string
- Access type: Read-only
The name of the user that opened the file handle.
- ClusterNodeName
-
- Data type: string
- Access type: Read-only
Name of the computer that is actually serving this handle. This is meaningful when the server is part of a cluster and the scope of the session might be served by several servers in the cluster.
- ContinuouslyAvailable
-
- Data type: boolean
- Access type: Read-only
Indicates whether this handle supports continuous availability. Continuously available handles will survive server failovers without any interruption to the client application.
- Encrypted
-
- Data type: boolean
- Access type: Read-only
Indicates whether the file is encrypted.
- FileId
-
- Data type: uint64
- Access type: Read-only
- Qualifiers: Key
An identifier that uniquely identifies the open file handle.
- Locks
-
- Data type: uint32
- Access type: Read-only
Number of locks held on this handle.
- Path
-
- Data type: string
- Access type: Read-only
Specified the server-local path to the opened file.
- Permissions
-
- Data type: uint32
- Access type: Read-only
The access mask for this handle.
- ScopeName
-
- Data type: string
- Access type: Read-only
Scope name of this handle. It can be * (meaning no scope) or a file server resource name (if the server is part of a cluster). ScopeName should match the scope name of the associated session.
- SessionId
-
- Data type: uint64
- Access type: Read-only
An identifier that identifies the session in which this file handle was opened.
- ShareRelativePath
-
- Data type: string
- Access type: Read-only
Specifies the share-relative path to the opened file.
Requirements
|
Minimum supported client | Windows 8 [desktop apps only] |
|---|---|
|
Minimum supported server | Windows Server 2012 [desktop apps only] |
|
Namespace |
\ROOT\Microsoft\Windows\Smb |
|
MOF |
|
|
DLL |
|
Send comments about this topic to Microsoft
Build date: 11/5/2012
