IDENTITY_ATTRIBUTE_BLOB

發行項
08/21/2008

更新：2007 年 11 月

包含組件中單一屬性的相關資訊，由三個 DWORD 組成。每個 DWORD 都是字元緩衝區中由 IEnumIDENTITY_ATTRIBUTE 介面的 CurrentIntoBuffer 方法所產生的位移。

typedef struct _IDENTITY_ATTRIBUTE_BLOB {
    DWORD  ofsNamespace;
    DWORD  ofsName;
    DWORD  ofsValue;
}   IDENTITY_ATTRIBUTE_BLOB;

成員

成員	描述
ofsNamespace	字元緩衝區中的第一個位移。這個位移後面不會接著屬性的命名空間，而是一連串 null 字元。因此，不使用它。
ofsName	字元緩衝區中的第二個位移。這個位置標記屬性名稱的開頭。
ofsValue	字元緩衝區中的第三個位移。這個位置標記屬性值的開頭。

範例

下列範例說明數個基本步驟，最後會產生填入的 IDENTITY_ATTRIBUTE_BLOB 結構：

取得組件的 IReferenceIdentity。
呼叫 IReferenceIdentity::EnumAttributes 方法，並取得 IEnumIDENTITY_ATTRIBUTE。
建立字元緩衝區，並將它轉換為 IDENTITY_ATTRIBUTE_BLOB 結構。
呼叫 IEnumIDENTITY_ATTRIBUTE 介面的 CurrentIntoBuffer 方法。這個方法會將屬性的 Namespace、Name 和 Value 複製到字元緩衝區中。這些字串的三個位移就會變成可在 IDENTITY_ATTRIBUTE_BLOB 結構中使用。

// EnumAssemblyAttributes.cpp : main project file.

#include "stdafx.h"

#include "fusion.h"
#include "windows.h"
#include "stdio.h"
#include "mscoree.h"
#include "isolation.h"

typedef HRESULT (__stdcall *PFNGETREF)(LPCWSTR pwzFile, REFIID riid, IUnknown **ppUnk);
typedef HRESULT (__stdcall *PFNGETAUTH)(IIdentityAuthority **ppIIdentityAuthority);

PFNGETREF                   g_pfnGetAssemblyIdentityFromFile = NULL;
PFNGETAUTH                  g_pfnGetIdentityAuthority = NULL;
IUnknown                    *g_pUnk = NULL;

bool Init()
{
    HRESULT     hr = S_OK;
    DWORD       dwSize = 0;
    bool        bRC = false;
    
    hr = CorBindToRuntimeEx(NULL, L"wks", 0, CLSID_CorRuntimeHost,
                           IID_ICorRuntimeHost, (void **)&g_pUnk);
    if(FAILED(hr)) {
        printf("Error: Failed to initialize CLR runtime! hr = 0x%0x\n",
                hr);
        goto Exit;
    }
   
    if (SUCCEEDED(hr)) {
        hr = GetRealProcAddress("GetAssemblyIdentityFromFile",
                         (VOID **)&g_pfnGetAssemblyIdentityFromFile);
    }

    if (SUCCEEDED(hr)) {
        hr = GetRealProcAddress("GetIdentityAuthority",
                                (VOID **)&g_pfnGetIdentityAuthority);
    }

    if (!g_pfnGetAssemblyIdentityFromFile || 
        !g_pfnGetIdentityAuthority)
    {
        printf("Error: Cannot get required APIs from fusion.dll!\n");
        goto Exit;
    }

    bRC = true;

Exit:
    return bRC;
}

void Shutdown()
{
    if(g_pUnk) {
        g_pUnk->Release();
        g_pUnk = NULL;
    }
}

void Usage()
{
    printf("EnumAssemblyAttributes: A tool to enumerate the identity 
            attributes of a given assembly.\n\n");
    printf("Usage: EnumAssemblyAttributes AssemblyFilePath\n");
    printf("\n");
}

int _cdecl wmain(int argc, LPCWSTR argv[])
{
    int     iResult = 1;
    IUnknown                    *pUnk  = NULL;
    IReferenceIdentity          *pRef  = NULL;
    HRESULT                     hr     = S_OK;   
    IEnumIDENTITY_ATTRIBUTE     *pEnum = NULL;
    BYTE                        abData[1024];
    DWORD                       cbAvailable;
    DWORD                       cbUsed;
    IDENTITY_ATTRIBUTE_BLOB     *pBlob;

    if(argc != 2) {
        Usage();
        goto Exit;
    }

    if(!Init()) {
        printf("Failure initializing EnumIdAttr.\n");
        goto Exit;
    }

    hr = g_pfnGetAssemblyIdentityFromFile(argv[1], 
                            __uuidof(IReferenceIdentity), &pUnk);

    if (FAILED(hr)) {
        printf("GetAssemblyIdentityFromFile failed with hr = 0x%x", 
                hr);
        goto Exit;
    }

    hr = pUnk->QueryInterface(__uuidof(IReferenceIdentity), 
                              (void**)&pRef);
    if (FAILED(hr)) {
        goto Exit;
    }

    hr = pRef->EnumAttributes(&pEnum);
    if (FAILED(hr)) {
        printf("IReferenceIdentity::EnumAttributes failed with hr = 
                0x%x", hr);
        goto Exit;
    }

    pBlob = (IDENTITY_ATTRIBUTE_BLOB *)(abData);
    while (1) {
        cbAvailable = sizeof(abData);
        hr = pEnum->CurrentIntoBuffer(cbAvailable, abData, &cbUsed);
        if (FAILED(hr)) {
            printf("IEnumIDENTITY_ATTRIBUTE::CurrentIntoBuffer failed 
                    with hr = 0x%x", hr);
            goto Exit;
        }

        if (! cbUsed) {
            break;
        }

        LPWSTR pwzNameSpace = (LPWSTR)(abData + pBlob->ofsNamespace);
        LPWSTR pwzName      = (LPWSTR)(abData + pBlob->ofsName);
        LPWSTR pwzValue     = (LPWSTR)(abData + pBlob->ofsValue);
        printf("%ws: %ws = %ws\n", pwzNameSpace, pwzName, pwzValue);

        hr = pEnum->Skip(1);
        if (FAILED(hr)) {
            printf("IEnumIDENTITY_ATTRIBUTE::Skip failed with hr = 
                    0x%x", hr);
            goto Exit;
        }
    }

    iResult = 0;

Exit:

    Shutdown();

    if (pUnk) {
        pUnk->Release();
    }

    if (pRef) {
        pRef->Release();
    }

    if (pEnum) {
        pEnum->Release();
    }

    return iResult;
}