共用方式為

winbase.h) (ACTCTX_SECTION_KEYED_DATA結構

  • 發行項

FindActCtxSectionString和FindActCtxSectionGuid函式會使用ACTCTX_SECTION_KEYED_DATA結構來傳回啟用內容資訊以及 GUID 或 32 位整數標記啟用內容區段。

語法

typedef struct tagACTCTX_SECTION_KEYED_DATA {
  ULONG                                       cbSize;
  ULONG                                       ulDataFormatVersion;
  PVOID                                       lpData;
  ULONG                                       ulLength;
  PVOID                                       lpSectionGlobalData;
  ULONG                                       ulSectionGlobalDataLength;
  PVOID                                       lpSectionBase;
  ULONG                                       ulSectionTotalLength;
  HANDLE                                      hActCtx;
  ULONG                                       ulAssemblyRosterIndex;
  ULONG                                       ulFlags;
  ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA AssemblyMetadata;
} ACTCTX_SECTION_KEYED_DATA, *PACTCTX_SECTION_KEYED_DATA;

成員

cbSize

啟用內容索引鍵資料結構的大小，以位元組為單位。

ulDataFormatVersion

數位，指出在找到索引鍵之區段中的資料格式。 用戶端應該確認資料格式版本如預期般運作，而不是嘗試解譯不熟悉的資料格式值。 只有在需要變更區段資料格式的主要非回溯相容變更時，才會變更此數位。 目前的格式版本為 1。

lpData

指向與區段識別碼和索引鍵相關聯的重新導向資料指標。

ulLength

lpData所參考之結構中的位元組數目。 請注意，資料結構會隨著時間成長;請勿存取超出 ulLength的實例資料中的成員。

lpSectionGlobalData

傳回區段特定資料結構的指標，這是找到金鑰之啟用內容區段的全域指標。 其解譯取決於所要求的區段識別碼。

ulSectionGlobalDataLength

lpSectionGlobalData所參考之全域資料區塊中的位元組數目。

請注意，資料結構會隨著時間成長，而且您可能會收到舊的格式啟用內容資料區塊;不會存取超出 ulSectionGlobalDataLength之全域資料區段中的成員。

lpSectionBase

指向找到索引鍵之區段基底的指標。 某些實例資料包含相對於區段基底位址的位移，在此情況下會使用這個指標值。

ulSectionTotalLength

從 lpSectionBase開始，整個區段的位元組數目。 可用來確認指定為相對於區段基底的位移/長度組，完全包含在 區段中。

hActCtx

處理找到金鑰的啟用內容。 首先，會搜尋執行緒的作用中啟用內容，後面接著進程預設啟用內容，然後搜尋系統相容的預設啟用內容。 這個成員會指出哪些啟用內容包含要求的區段和金鑰。 只有在傳遞FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX旗標時，才會傳回這個值。

請注意，當傳回此情況時，呼叫端必須在啟動內容控制碼上呼叫 ReleaseActCtx () ，當啟動內容的其他所有參考都已釋放時，傳回給釋放系統資源。

ulAssemblyRosterIndex

啟用內容中提供重新導向資訊的元件基數。 此值可以呈現給 QueryActCtxW ，以取得參與元件的詳細資訊。

ulFlags

AssemblyMetadata

備註

呼叫端應該初始化 ACTCTX_SECTION_KEYED_DATA 結構，例如：

「ACTCTX_SECTION_KEYED_DATA askd = { sizeof (askd) };」

會將所有成員初始化為零/Null，但已正確設定的大小欄位除外。

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 winbase.h (包含 Windows.h)

另請參閱

ACTCTX

FindActCtxSectionGuid

FindActCtxSectionString