NETWORK_OPEN_ECP_CONTEXT_V0 結構 (ntifs.h)

發行項
02/29/2024

NETWORK_OPEN_ECP_CONTEXT_V0 結構可用來解譯檔案上的網路額外建立參數 (ECP) 內容。

語法

typedef struct _NETWORK_OPEN_ECP_CONTEXT_V0 {
  USHORT Size;
  USHORT Reserved;
  struct {
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
    } in;
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
    } out;
  } DUMMYSTRUCTNAME;
} NETWORK_OPEN_ECP_CONTEXT_V0, *PNETWORK_OPEN_ECP_CONTEXT_V0;

成員

Size

這個結構的大小，以位元組為單位。

Reserved

保留的。必須設定為零。

DUMMYSTRUCTNAME

結構，其中包含開啟檔案 (預先建立) 的限制，並在建立) 後 (後套用至檔案。

DUMMYSTRUCTNAME.in

結構，包含開啟檔案的預先建立限制。

DUMMYSTRUCTNAME.in.Location

NETWORK_OPEN_LOCATION_QUALIFIER型別值，指定附加至檔案的位置限制。

DUMMYSTRUCTNAME.in.Integrity

NETWORK_OPEN_INTEGRITY_QUALIFIER型別值，指定附加至檔案的完整性限制。

DUMMYSTRUCTNAME.out

結構，其中包含在開啟檔案之後套用至檔案的建立後限制。

DUMMYSTRUCTNAME.out.Location

NETWORK_OPEN_LOCATION_QUALIFIER型別值，指定附加至檔案的位置限制。

DUMMYSTRUCTNAME.out.Integrity

此成員目前未實作，而且應該予以忽略。

NETWORK_OPEN_INTEGRITY_QUALIFIER型別值，指定附加至檔案的完整性限制。

備註

如需有關如何在建立檔案時使用 ECP 將額外資訊與檔案產生關聯的資訊，請參閱搭配使用額外的建立參數與IRP_MJ_CREATE作業。

篩選驅動程式應該將NETWORK_OPEN_ECP_CONTEXT結構視為唯讀，只使用它來擷取檔案上網路 ECP 內容的相關信息。如需詳細資訊，請參閱系統定義的 ECP。

如果呼叫端必須確認文件系統確認 NETWORK_OPEN_ECP_CONTEXT_V0 內容結構，呼叫端應該在作業完成之後呼叫 ECP 上的 FltIsEcpAcknowledged 或 FsRtlIsEcpAcknowledged 例程。

在大部分情況下，在 Windows Vista 和更新版本的 Windows 上執行的驅動程式會使用 NETWORK_OPEN_ECP_CONTEXT 結構來解譯檔案上的網路 ECP 內容。不過，在 Windows 7 和更新版本的 Windows 上執行的驅動程式，而且必須解譯位於 Windows Vista 上檔案的網路 ECP 內容，則必須改用 NETWORK_OPEN_ECP_CONTEXT_V0 結構。