IAppIdAuthority Interface

  • Article

Provides methods that generate and compare keys for application identities and references.

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
    );
        
};

Methods

Method Description

IAppIdAuthority::AreDefinitionsEqual

Gets a value that indicates whether the two specified IDefinitionAppId Interface instances are equal. You can pass the flag value IAPPIDAUTHORITY_ARE_DEFINITIONS_EQUAL_FLAG_IGNORE_VERSION to ignore their respective version information.

IAppIdAuthority::AreReferencesEqual

Gets a value that indicates whether the two specified IReferenceAppId Interface instances are equal. You can pass the flag value IAPPIDAUTHORITY_ARE_REFERENCES_EQUAL_FLAG_IGNORE_VERSION to ignore their respective version information.

IAppIdAuthority::AreTextualDefinitionsEqual

Gets a value that indicates whether the two specified string definitions are equal. You can pass the flag value IAPPIDAUTHORITY_ARE_DEFINITIONS_EQUAL_FLAG_IGNORE_VERSION to ignore their respective version information.

IAppIdAuthority::AreTextualReferencesEqual

Gets a value that indicates whether the two specified string references are equal. You can pass the flag value IAPPIDAUTHORITY_ARE_REFERENCES_EQUAL_FLAG_IGNORE_VERSION to ignore their respective version information.

IAppIdAuthority::CreateDefinition

Gets an interface pointer to a newly generated IDefinitionAppId instance that represents the assembly in the current scope.

IAppIdAuthority::CreateReference

Gets an interface pointer to a newly created IReferenceAppId that represents the assembly in the current scope.

IAppIdAuthority::DefinitionToText

Gets a string version of the specified IDefinitionAppId, using the specified flag values.

IAppIdAuthority::DoesDefinitionMatchReference

Gets a value that indicates whether the specified IDefinitionAppId and IReferenceAppId represent the same assembly.

IAppIdAuthority::DoesTextualDefinitionMatchTextualReference

Gets a value that indicates whether the specified definition string and reference string represent the same assembly.

IAppIdAuthority::GenerateDefinitionKey

Gets a string key that represents the specified IDefinitionAppId instance.

IAppIdAuthority::GenerateReferenceKey

Gets a string key that represents the specified IReferenceAppId instance.

IAppIdAuthority::HashDefinition

Gets a hash key for the specified IDefinitionAppId instance.

IAppIdAuthority::HashReference

Gets a hash key for the specified IReferenceAppId instance.

IAppIdAuthority::ReferenceToText

Gets a string version of the specified IReferenceAppId, using the specified flag values.

IAppIdAuthority::TextToDefinition

Gets an interface pointer to an IDefinitionAppId instance that represents the assembly referenced by the specified string key.

IAppIdAuthority::TextToReference

Gets an interface pointer to an IReferenceAppId instance that represents the assembly referenced by the specified string key.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: Isolation.h

.NET Framework Version: 2.0

See Also

Other Resources

Fusion Interfaces