IIdentityAuthority

更新：2007 年 11 月

管理程式碼物件的識別鍵。

interface IIdentityAuthority : IUnknown {
        
    HRESULT AreDefinitionsEqual (
        [in]  DWORD               dwFlags,
        [in]  IDefinitionIdentity *pDefinition1,
        [in]  IDefinitionIdentity *pDefinition2,
        [out] BOOL                *pfEqual
    );
        
    HRESULT AreReferencesEqual (
        [in]  DWORD               dwFlags,
        [in]  IReferenceIdentity  *pReference1,
        [in]  IReferenceIdentity  *pReference2,
        [out] BOOL                *pfEqual
    );
        
    HRESULT AreTextualDefinitionsEqual (
        [in]  DWORD               dwFlags,
        [in]  LPCWSTR             pszIdentityLeft,
        [in]  LPCWSTR             pszIdentityRight,
        [out] BOOL                *pfEqual
    );
        
    HRESULT AreTextualReferencesEqual (
        [in]  DWORD               dwFlags,
        [in]  LPCWSTR             pszIdentityLeft,
        [in]  LPCWSTR             pszIdentityRight,
        [out] BOOL                *pfEqual
    );
        
    HRESULT CreateDefinition (
        [retval][out] IDefinitionIdentity **ppNewIdentity
    );
        
    HRESULT CreateReference (
        [retval][out] IReferenceIdentity  **ppNewIdentity
    );
        
    HRESULT DefinitionToText (
        [in]  DWORD               dwFlags,
        [in]  IDefinitionIdentity  *pIDefinitionIdentity,
           [out] LPWSTR               *ppszFormattedIdentity
    );
        
    HRESULT DefinitionToTextBuffer (
        [in]  DWORD                dwFlags,
        [in]  IDefinitionIdentity  *pIDefinitionIdentity,
        [in]  ULONG                cchBufferSize,
        [in, out, length_is(cchBufferSize),
            size_is(pcchBufferRequired)] WCHAR wchBuffer[],
        [out] ULONG                *pcchBufferRequired
    );
        
    HRESULT DoesDefinitionMatchReference (
        [in]  DWORD                dwFlags,
        [in]  IDefinitionIdentity  *pIDefinitionIdentity,
        [in]  IReferenceIdentity   *pIReferenceIdentity,
        [out] BOOL                 *pfMatches
    );
        
    HRESULT DoesTextualDefinitionMatchTextualReference (
        [in]  DWORD   dwFlags,
        [in]  LPCWSTR pszDefinition,
        [in]  LPCWSTR pszReference,
        [out] BOOL    *pfMatches
    );
        
    HRESULT GenerateDefinitionKey (
        [in]  DWORD               dwFlags,
        [in]  IDefinitionIdentity *pIDefinitionIdentity,
        [out] LPWSTR              *ppszKeyForm
    );
        
    HRESULT GenerateReferenceKey (
        [in]  DWORD               dwFlags,
        [in]  IReferenceIdentity  *pIReferenceIdentity,
        [out] LPWSTR              *ppszKeyForm
    );    
        
    HRESULT HashDefinition (
        [in]  DWORD                dwFlags,
        [in]  IDefinitionIdentity  *pIDefinitionIdentity,
        [out] ULONGLONG            *pullPseudoKey
    );
        
    HRESULT HashReference (
        [in]  DWORD                dwFlags,
        [in]  IReferenceIdentity   *pIReferenceIdentity,
        [out] ULONGLONG            *pullPseudoKey
    );
        
    HRESULT ReferenceToText (
        [in]  DWORD                 dwFlags,
        [in]  IReferenceIdentity    *pIReferenceIdentity,
             [out] LPWSTR                *ppszFormattedIdentity
    );
        
    HRESULT ReferenceToTextBuffer (
        [in]  DWORD                 dwFlags,
        [in]  IReferenceIdentity    *pIReferenceIdentity,
        [in]  ULONG                 cchBufferSize,
        [in, out, length_is(cchBufferSize),
            size_is(pcchBufferRequired)] WCHAR wchBuffer[],
        [out] ULONG                 *pcchBufferRequired
    );
        
    HRESULT TextToDefinition (
        [in]  DWORD                 dwFlags,
        [in]  LPCWSTR               pszIdentity,
        [out] IDefinitionIdentity   **ppIDefinitionIdentity
    );
        
    HRESULT TextToReference (
        [in]  DWORD                 dwFlags,
        [in]  LPCWSTR               pszIdentity,
               [out] IReferenceIdentity    **ppIReferenceIdentity
    );
        
};

方法

方法	描述
IIdentityAuthority::AreDefinitionsEqual	取得值，指出兩個指定的 IDefinitionIdentity 執行個體是否相等。
IIdentityAuthority::AreReferencesEqual	取得值，指出兩個指定的 IReferenceIdentity 執行個體是否相等。
IIdentityAuthority::AreTextualDefinitionsEqual	取得值，指出兩個指定的字串定義識別表示是否相等。
IIdentityAuthority::AreTextualReferencesEqual	取得值，指出兩個指定的字串參考識別是否相等。
IIdentityAuthority::CreateDefinition	取得新 IDefinitionIdentity 執行個體的指標，指出目前範圍中的程式碼物件。
IIdentityAuthority::CreateReference	取得新 IReferenceIdentity 執行個體的指標，指出目前範圍中的程式碼物件。
IIdentityAuthority::DefinitionToText	取得指定的 IDefinitionIdentity 的格式化字串版本。
IIdentityAuthority::DefinitionToTextBuffer	以指定的 IDefinitionIdentity 的字串版本填入指定的寬字元緩衝區。
IIdentityAuthority::DoesDefinitionMatchReference	取得值，指出指定的 IDefinitionIdentity 和 IReferenceIdentity 執行個體是否都參考相同的程式碼物件。
IIdentityAuthority::DoesTextualDefinitionMatchTextualReference	取得值，指出指定的字串是否參考相同的程式碼物件。
IIdentityAuthority::GenerateDefinitionKey	取得指定 IDefinitionIdentity 的新建立字串鍵的指標。
IIdentityAuthority::GenerateReferenceKey	取得指定 IReferenceIdentity 的新建立字串鍵的指標。
IIdentityAuthority::HashDefinition	取得指定的 IDefinitionIdentity 的雜湊值 (Hash Value)。
IIdentityAuthority::HashReference	取得指定的 IreferenceIdentity 的雜湊值 (Hash Value)。
IIdentityAuthority::ReferenceToText	取得指定的 IReferenceIdentity 的格式化字串版本。
IIdentityAuthority::ReferenceToTextBuffer	以指定的 IReferenceIdentity 的字串版本填入指定的寬字元緩衝區。
IIdentityAuthority::TextToDefinition	取得從指定的格式化字串產生的 IDefinitionIdentity 執行個體介面指標。
IIdentityAuthority::TextToReference	取得從指定的格式化字串產生的 IReferenceIdentity 執行個體介面指標。

需求

**平台：**請參閱 .NET Framework 系統需求。

**標頭：**Isolation.h

**.NET Framework 版本：**3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

請參閱

其他資源

融合介面