NETWORK_OPEN_ECP_CONTEXT_V0結構（ntifs.h）

發行項
12/21/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 內容的相關信息。如需詳細資訊，請參閱 System-Defined ECP。

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

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