Share via

ACTCTX_SECTION_KEYED_DATA 구조체(winbase.h)

  • 아티클

ACTCTX_SECTION_KEYED_DATA 구조체는 FindActCtxSectionString 및 FindActCtxSectionGuid 함수에서 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 이상으로 확장되는 instance 데이터의 멤버에 액세스하지 않습니다.

lpSectionGlobalData

키가 발견된 활성화 컨텍스트 섹션에 전역인 섹션별 데이터 구조에 대한 포인터를 반환했습니다. 해당 해석은 요청된 섹션 식별자에 따라 달라집니다.

ulSectionGlobalDataLength

lpSectionGlobalData에서 참조하는 섹션 전역 데이터 블록의 바이트 수입니다.

데이터 구조는 시간이 지남에 따라 증가하고 이전 형식 활성화 컨텍스트 데이터 블록을 받을 수 있습니다. 는 ulSectionGlobalDataLength 이상으로 확장되는 섹션 전역 데이터의 멤버에 액세스하지 않습니다.

lpSectionBase

키를 찾은 섹션의 밑면에 대한 포인터입니다. 일부 instance 데이터에는 섹션 기본 주소를 기준으로 하는 오프셋이 포함되며, 이 경우 이 포인터 값이 사용됩니다.

ulSectionTotalLength

lpSectionBase부터 시작하는 전체 섹션의 바이트 수입니다. 섹션 베이스를 기준으로 지정된 오프셋/길이 쌍이 섹션에 완전히 포함되어 있는지 확인하는 데 사용할 수 있습니다.

hActCtx

키를 찾은 활성화 컨텍스트에 대한 핸들입니다. 먼저 스레드에 대한 활성 활성화 컨텍스트를 검색한 다음 프로세스-기본 활성화 컨텍스트 및 시스템 호환-default-activation 컨텍스트를 검색합니다. 이 멤버는 요청된 섹션 및 키를 포함하는 활성화 컨텍스트를 나타냅니다. FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX 플래그가 전달된 경우에만 반환됩니다.

이 값이 반환되면 호출자는 활성화 컨텍스트에 대한 다른 모든 참조가 해제된 경우 시스템 리소스를 해제하기 위해 반환된 활성화 컨텍스트 핸들에서 ReleaseActCtx()를 호출해야 합니다.

ulAssemblyRosterIndex

찾은 리디렉션 정보를 제공한 활성화 컨텍스트의 어셈블리의 카디널 번호입니다. 이 값은 기여하는 어셈블리에 대한 자세한 내용은 QueryActCtxW 에 표시될 수 있습니다.

ulFlags

AssemblyMetadata

설명

호출자는 다음과 같이 ACTCTX_SECTION_KEYED_DATA 구조를 초기화해야 합니다.

"ACTCTX_SECTION_KEYED_DATA askd = { sizeof(askd) };"

올바르게 설정된 크기 필드를 제외한 모든 멤버를 0/null로 초기화합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 winbase.h(Windows.h 포함)

추가 정보

ACTCTX

FindActCtxSectionGuid

FindActCtxSectionString