IAppIdAuthority

更新：2007 年 11 月

提供產生和比較應用程式識別鍵和參考鍵的方法。

interface IAppIdAuthority : IUnknown {
        
    [v1_enum]
    enum IAPPIDAUTHORITY_ARE_DEFINITIONS_EQUAL_FLAGS {
        IAPPIDAUTHORITY_ARE_DEFINITIONS_EQUAL_FLAG_IGNORE_VERSION
            = 0x00000001,
    };
        
    HRESULT AreDefinitionsEqual (
        [in]  DWORD             dwFlags,
        [in]  IDefinitionAppId  *pDefinition1,
        [in]  IDefinitionAppId  *pDefinition2,
        [out] BOOL             *pfAreEqual
    );
        
    [v1_enum]
    enum IAPPIDAUTHORITY_ARE_REFERENCES_EQUAL_FLAGS {
        IAPPIDAUTHORITY_ARE_REFERENCES_EQUAL_FLAG_IGNORE_VERSION
           = 0x00000001,
    };

    HRESULT AreReferencesEqual (
        [in]  DWORD             dwFlags,
        [in]  IReferenceAppId   *pReference1,
        [in]  IReferenceAppId   *pReference2,
        [out] BOOL             *pfAreEqual
    );
        
    HRESULT AreTextualDefinitionsEqual (
        [in]  DWORD             dwFlags,
        [in]  LPCWSTR           pszAppIdLeft,
        [in]  LPCWSTR           pszAppIdRight,
        [out] BOOL             *pfAreEqual
    );
        
    HRESULT AreTextualReferencesEqual (
        [in]  DWORD             dwFlags,
        [in]  LPCWSTR           pszAppIdLeft,
        [in]  LPCWSTR           pszAppIdRight,
        [out] BOOL             *pfAreEqual
    );
        
    HRESULT CreateDefinition (
        [out, retval] IDefinitionAppId **ppNewIdentity
    );
        
    HRESULT CreateReference (
        [out, retval] IReferenceAppId **ppNewIdentity
    );
        
    HRESULT DefinitionToText (
        [in]  DWORD             dwFlags,
        [in]  IDefinitionAppId  *pIDefinitionAppId,
        [out] LPWSTR           *ppszFormattedIdentity
    );
        
    HRESULT DoesDefinitionMatchReference (
        [in]  DWORD             dwFlags,
        [in]  IDefinitionAppId  *pIDefinitionIdentity,
        [in]  IReferenceAppId   *pIReferenceIdentity,
        [out] BOOL             *pfMatches
    );
        
    HRESULT DoesTextualDefinitionMatchTextualReference (
        [in]  DWORD             dwFlags,
        [in]  LPCWSTR           pszDefinition,
        [in]  LPCWSTR           pszReference,
        [out] BOOL             *pfMatches
    );
        
    HRESULT GenerateDefinitionKey (
        [in]  DWORD             dwFlags,
        [in]  IDefinitionAppId  *pIDefinitionIdentity,
        [out] LPWSTR           *ppszKeyForm
    );
        
    HRESULT GenerateReferenceKey (
        [in]  DWORD             dwFlags,
        [in]  IReferenceAppId   *pIReferenceIdentity,
        [out] LPWSTR           *ppszKeyForm
    );
        
    HRESULT HashDefinition (
        [in]  DWORD             dwFlags,
        [in]  IDefinitionAppId  *pIDefinitionIdentity,
        [out] ULONGLONG        *pullPseudoKey
    );
        
    HRESULT HashReference (
        [in]  DWORD             dwFlags,
        [in]  IReferenceAppId   *pIReferenceIdentity,
        [out] ULONGLONG        *pullPseudoKey
    );
        
    HRESULT ReferenceToText (
        [in]  DWORD             dwFlags,
        [in]  IReferenceAppId   *pIReferenceAppId,
        [out] LPWSTR           *ppszFormattedIdentity
    );
        
    HRESULT TextToDefinition (
        [in]  DWORD             dwFlags,
        [in]  LPCWSTR           pszIdentity,
        [out] IDefinitionAppId **ppIDefinitionAppId
    );
        
    HRESULT TextToReference (
        [in]  DWORD             dwFlags,
        [in]  LPCWSTR           pszIdentity,
        [out] IReferenceAppId  **ppIReferenceAppId
    );
        
};

方法

方法	描述
IAppIdAuthority::AreDefinitionsEqual	取得值，這個值會指出兩個指定的 IDefinitionAppId 執行個體是否相等。您可以傳遞旗標值 IAPPIDAUTHORITY_ARE_DEFINITIONS_EQUAL_FLAG_IGNORE_VERSION，以忽略執行個體的各自版本資訊。
IAppIdAuthority::AreReferencesEqual	取得值，這個值會指出兩個指定的 IReferenceAppId 執行個體是否相等。您可以傳遞旗標值 IAPPIDAUTHORITY_ARE_REFERENCES_EQUAL_FLAG_IGNORE_VERSION，以忽略執行個體的各自版本資訊。
IAppIdAuthority::AreTextualDefinitionsEqual	取得值，指出兩個指定的字串定義是否相等。您可以傳遞旗標值 IAPPIDAUTHORITY_ARE_DEFINITIONS_EQUAL_FLAG_IGNORE_VERSION，以忽略執行個體的各自版本資訊。
IAppIdAuthority::AreTextualReferencesEqual	取得值，指出兩個指定的字串參考是否相等。您可以傳遞旗標值 IAPPIDAUTHORITY_ARE_REFERENCES_EQUAL_FLAG_IGNORE_VERSION，以忽略執行個體的各自版本資訊。
IAppIdAuthority::CreateDefinition	取得新產生之 IDefinitionAppId 執行個體的介面指標，表示目前範圍中的組件。
IAppIdAuthority::CreateReference	取得新建立 IReferenceAppId 執行個體的介面指標，表示目前範圍中的組件。
IAppIdAuthority::DefinitionToText	取得指定的 IDefinitionAppId 的字串版本 (使用指定的旗標值)。
IAppIdAuthority::DoesDefinitionMatchReference	取得值，指出指定的 IDefinitionAppId 和 IReferenceAppId 是否表示相同的組件。
IAppIdAuthority::DoesTextualDefinitionMatchTextualReference	取得值，指出指定的定義字串和參考字串是否表示相同的組件。
IAppIdAuthority::GenerateDefinitionKey	取得字串鍵，表示指定的 IDefinitionAppId 執行個體。
IAppIdAuthority::GenerateReferenceKey	取得字串鍵，表示指定的 IReferenceAppId 執行個體。
IAppIdAuthority::HashDefinition	取得指定的 IDefinitionAppId 執行個體的雜湊機碼。
IAppIdAuthority::HashReference	取得指定之 IReferenceAppId 執行個體的雜湊機碼。
IAppIdAuthority::ReferenceToText	取得指定的 IReferenceAppId 的字串版本 (使用指定的旗標值)。
IAppIdAuthority::TextToDefinition	取得 IDefinitionAppId 執行個體的介面指標，表示由指定的字串鍵所參考的組件。
IAppIdAuthority::TextToReference	取得 IReferenceAppId 執行個體的介面指標，表示由指定的字串鍵所參考的組件。

需求

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

**標頭：**Isolation.h

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

請參閱

其他資源

融合介面