FILE_REMOTE_PROTOCOL_INFO-Struktur (winbase.h)

Enthält Datei-Remoteprotokollinformationen. Diese Struktur wird von der GetFileInformationByHandleEx-Funktion zurückgegeben, wenn FileRemoteProtocolInfo im FileInformationClass-Parameter übergeben wird.

Syntax

typedef struct _FILE_REMOTE_PROTOCOL_INFO {
  USHORT StructureVersion;
  USHORT StructureSize;
  ULONG  Protocol;
  USHORT ProtocolMajorVersion;
  USHORT ProtocolMinorVersion;
  USHORT ProtocolRevision;
  USHORT Reserved;
  ULONG  Flags;
  struct {
    ULONG Reserved[8];
  } GenericReserved;
  struct {
    ULONG Reserved[16];
  } ProtocolSpecificReserved;
  union {
    struct {
      struct {
        ULONG Capabilities;
      } Server;
      struct {
        ULONG Capabilities;
        ULONG ShareFlags;
        ULONG CachingFlags;
      } Share;
    } Smb2;
    ULONG Reserved[16];
  } ProtocolSpecific;
} FILE_REMOTE_PROTOCOL_INFO, *PFILE_REMOTE_PROTOCOL_INFO;

Member

StructureVersion

Version dieser Struktur. Dieser Member sollte auf 2 festgelegt werden, wenn die Kommunikation zwischen Computern erfolgt, die Windows 8, Windows Server 2012 oder höher und 1 andernfalls ausgeführt werden.

StructureSize

Größe dieser Struktur. Dieses Element sollte auf sizeof(FILE_REMOTE_PROTOCOL_INFO)festgelegt werden.

Protocol

Remoteprotokoll (WNNC_NET_*) definiert in Wnnc.h oder Ntifs.h.

WNNC_NET_MSNET (0x00010000)

WNNC_NET_SMB (0x00020000)

WNNC_NET_LANMAN (0x00020000)

WNNC_NET_NETWARE (0x00030000)

WNNC_NET_VINES (0x00040000)

WNNC_NET_10NET (0x00050000)

WNNC_NET_LOCUS (0x00060000)

WNNC_NET_SUN_PC_NFS (0x00070000)

WNNC_NET_LANSTEP (0x00080000)

WNNC_NET_9TILES (0x00090000)

WNNC_NET_LANTASTIC (0x000A0000)

WNNC_NET_AS400 (0x000B0000)

WNNC_NET_FTP_NFS (0x000C0000)

WNNC_NET_PATHWORKS (0x000D0000)

WNNC_NET_LIFENET (0x000E0000)

WNNC_NET_POWERLAN (0x000F0000)

WNNC_NET_BWNFS (0x00100000)

WNNC_NET_COGENT (0x00110000)

WNNC_NET_FARALLON (0x00120000)

WNNC_NET_APPLETALK (0x00130000)

WNNC_NET_INTERGRAPH (0x00140000)

WNNC_NET_SYMFONET (0x00150000)

WNNC_NET_CLEARCASE (0x00160000)

WNNC_NET_FRONTIER (0x00170000)

WNNC_NET_BMC (0x00180000)

WNNC_NET_DCE (0x00190000)

WNNC_NET_AVID (0x001A0000)

WNNC_NET_DOCUSPACE (0x001B0000)

WNNC_NET_MANGOSOFT (0x001C0000)

WNNC_NET_SERNET (0x001D0000)

WNNC_NET_RIVERFRONT1 (0x001E0000)

WNNC_NET_RIVERFRONT2 (0x001F0000)

WNNC_NET_DECORB (0x00200000)

WNNC_NET_PROTSTOR (0x00210000)

WNNC_NET_FJ_REDIR (0x00220000)

WNNC_NET_DISTINCT (0x00230000)

WNNC_NET_TWINS (0x00240000)

WNNC_NET_RDR2SAMPLE (0x00250000)

WNNC_NET_CSC (0x00260000)

WNNC_NET_3IN1 (0x00270000)

WNNC_NET_EXTENDNET (0x00290000)

WNNC_NET_STAC (0x002A0000)

WNNC_NET_FOXBAT (0x002B0000)

WNNC_NET_YAHOO (0x002C0000)

WNNC_NET_EXIFS (0x002D0000)

WNNC_NET_DAV (0x002E0000)

WNNC_NET_KNOWARE (0x002F0000)

WNNC_NET_OBJECT_DIRE (0x00300000)

WNNC_NET_MASFAX (0x00310000)

WNNC_NET_HOB_NFS (0x00320000)

WNNC_NET_SHIVA (0x00330000)

WNNC_NET_IBMAL (0x00340000)

WNNC_NET_LOCK (0x00350000)

WNNC_NET_TERMSRV (0x00360000)

WNNC_NET_SRT (0x00370000)

WNNC_NET_QUINCY (0x00380000)

WNNC_NET_OPENAFS (0x00390000)

WNNC_NET_AVID1 (0x003A0000)

WNNC_NET_DFS (0x003B0000)

WNNC_NET_KWNP (0x003C0000)

WNNC_NET_ZENWORKS (0x003D0000)

WNNC_NET_DRIVEONWEB (0x003E0000)

WNNC_NET_VMWARE (0x003F0000)

WNNC_NET_RSFX (0x00400000)

WNNC_NET_MFILES (0x00410000)

WNNC_NET_MS_NFS (0x00420000)

WNNC_NET_GOOGLE (0x00430000)

WNNC_NET_NDFS (0x00440000)

ProtocolMajorVersion

Hauptversion des Remoteprotokolls.

ProtocolMinorVersion

Nebenversion des Remoteprotokolls.

ProtocolRevision

Revision des Remoteprotokolls.

Reserved

Sollte auf Null festgelegt werden. Verwenden Sie dieses Element nicht.

Flags

Remoteprotokollinformationen. Dieses Element kann auf 0 oder mehr der folgenden Flags festgelegt werden.

Wert	Bedeutung
REMOTE_PROTOCOL_FLAG_LOOPBACK 0x1	Das Remoteprotokoll verwendet ein Loopback.
REMOTE_PROTOCOL_FLAG_OFFLINE 0x2	Das Remoteprotokoll verwendet einen Offlinecache.
REMOTE_PROTOCOL_INFO_FLAG_PERSISTENT_HANDLE 0x4	Das Remoteprotokoll verwendet ein persistentes Handle. Windows 7 und Windows Server 2008 R2: Dieses Flag wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
REMOTE_PROTOCOL_INFO_FLAG_PRIVACY 0x8	Das Remoteprotokoll verwendet Datenschutz. Dies wird nur unterstützt, wenn das StructureVersion-Element 2 oder höher ist. Windows 7 und Windows Server 2008 R2: Dieses Flag wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
REMOTE_PROTOCOL_INFO_FLAG_INTEGRITY 0x10	Das Remoteprotokoll verwendet Integrität, sodass die Daten signiert werden. Dies wird nur unterstützt, wenn das StructureVersion-Element 2 oder höher ist. Windows 7 und Windows Server 2008 R2: Dieses Flag wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
REMOTE_PROTOCOL_INFO_FLAG_MUTUAL_AUTH 0x20	Das Remoteprotokoll verwendet die gegenseitige Authentifizierung mithilfe von Kerberos. Dies wird nur unterstützt, wenn das StructureVersion-Element 2 oder höher ist. Windows 7 und Windows Server 2008 R2: Dieses Flag wird vor Windows 8 und Windows Server 2012 nicht unterstützt.

GenericReserved

Protokollgenerische Informationsstruktur.

GenericReserved.Reserved[8]

Sollte auf Null festgelegt werden. Verwenden Sie dieses Element nicht.

ProtocolSpecificReserved

Protokollspezifische Informationsstruktur.

ProtocolSpecificReserved.Reserved[16]

Sollte auf Null festgelegt werden. Verwenden Sie dieses Element nicht.

ProtocolSpecific

ProtocolSpecific.Smb2

ProtocolSpecific.Smb2.Server

ProtocolSpecific.Smb2.Server.Capabilities

ProtocolSpecific.Smb2.Share

ProtocolSpecific.Smb2.Share.Capabilities

ProtocolSpecific.Smb2.Share.ShareFlags

ProtocolSpecific.Smb2.Share.CachingFlags

ProtocolSpecific.Reserved[16]

Hinweise

Die FILE_REMOTE_PROTOCOL_INFO-Struktur ist nur für die Verwendung mit der GetFileInformationByHandleEx-Funktion gültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile	winbase.h (einschließlich Windows.h)

Weitere Informationen

FILE_INFO_BY_HANDLE_CLASS

GetFileInformationByHandleEx