winnt.h) (ACTIVATION_CONTEXT_DETAILED_INFORMATION 结构

ACTIVATION_CONTEXT_DETAILED_INFORMATION 结构由 QueryActCtxW 函数使用。

语法

typedef struct _ACTIVATION_CONTEXT_DETAILED_INFORMATION {
  DWORD  dwFlags;
  DWORD  ulFormatVersion;
  DWORD  ulAssemblyCount;
  DWORD  ulRootManifestPathType;
  DWORD  ulRootManifestPathChars;
  DWORD  ulRootConfigurationPathType;
  DWORD  ulRootConfigurationPathChars;
  DWORD  ulAppDirPathType;
  DWORD  ulAppDirPathChars;
  PCWSTR lpRootManifestPath;
  PCWSTR lpRootConfigurationPath;
  PCWSTR lpAppDirPath;
} ACTIVATION_CONTEXT_DETAILED_INFORMATION, *PACTIVATION_CONTEXT_DETAILED_INFORMATION;

成员

dwFlags

此值始终为 0。

ulFormatVersion

此值指定返回信息的格式。 在 Windows XP 和 Windows Server 2003 上，此成员始终为 1。

ulAssemblyCount

激活上下文中的程序集数。

ulRootManifestPathType

指定从中加载此程序集清单的路径类型。

此成员始终是下列常量之一：

ulRootManifestPathChars

清单路径中的字符数。

ulRootConfigurationPathType

指定从中加载此程序集的应用程序配置清单的路径类型。

此成员始终是下列常量之一：

ulRootConfigurationPathChars

任何应用程序配置文件路径中的字符数。

ulAppDirPathType

指定从中加载此应用程序清单的路径类型。

此成员始终是下列常量之一：

ulAppDirPathChars

应用程序目录中的字符数。

lpRootManifestPath

应用程序清单的路径。

lpRootConfigurationPath

配置文件的路径。

lpAppDirPath

应用程序目录的路径。

注解

如果使用 ActivationContextDetailedInformation 选项调用 QueryActCtxW ，并且函数成功，则返回的缓冲区中的信息采用 ACTIVATION_CONTEXT_DETAILED_INFORMATION 结构的形式。 下面是一个结构示例，该结构用于保存有关激活上下文的详细信息以及 来自 QueryActCtxW 的调用。

PACTIVATION_CONTEXT_DETAILED_INFORMATION pAssemblyInfo = NULL;
ACTIVATION_CONTEXT_QUERY_INDEX QueryIndex;
BOOL fSuccess = FALSE;
SIZE_T cbRequired;
HANDLE hActCtx = INVALID_HANDLE_VALUE;
BYTE bTemporaryBuffer[512];
PVOID pvDataBuffer = (PVOID)bTemporaryBuffer;
SIZE_T cbAvailable = sizeof(bTemporaryBuffer);

// Request the first file in the root assembly
QueryIndex.ulAssemblyIndex = 1;
QueryIndex.ulFileIndexInAssembly = 0;

if (GetCurrentActCtx(&hActCtx)) {

    // Attempt to use our stack-based buffer first - if that's not large
    // enough, allocate from the heap and try again.
    fSuccess = QueryActCtxW(
        0, 
        hActCtx, 
        (PVOID)&QueryIndex, 
        AssemblyDetailedInformationInActivationContext,
        pvDataBuffer,
        cbAvailable,
        &cbRequired);

    // Failed, because the buffer was too small.
    if (!fSuccess && (GetLastError() == ERROR_INSUFFICIENT_BUFFER)) {

        // Allocate what we need from the heap - fail if there isn't enough
        // memory to do so.        
        pvDataBuffer = HeapAlloc(GetProcessHeap(), 0, cbRequired);
        if (pvDataBuffer == NULL) {
            fSuccess = FALSE;
            goto DoneQuerying;
        }
        cbAvailable = cbRequired;

        // If this fails again, exit out.
        fSuccess = QueryActCtxW(
            0, 
            hActCtx,
            (PVOID)&QueryIndex,
            AssemblyDetailedInformationInActivationContext,
            pvDataBuffer,
            cbAvailable,
            &cbRequired);

    }

    if (fSuccess) {
        // Now that we've found the assembly info, cast our target buffer back to
        // the assembly info pointer.  Use pAssemblyInfo->lpFileName
        pAssemblyInfo = (PACTIVATION_CONTEXT_DETAILED_INFORMATION)pvDataBuffer;
    }
}

DoneQuerying:
    if (hActCtx != INVALID_HANDLE_VALUE)
        ReleaseActCtx(hActCtx);

    if (pvDataBuffer && (pvDataBuffer != bTemporaryBuffer)) {
        HeapFree(GetProcessHeap(), 0, pvDataBuffer);
        pvDataBuffer = 0;
    }

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	winnt.h (包括 Windows.h)