IAppIdAuthority Interface

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