IBuilderWizardManager.MapBuilderCATIDToCLSID(Guid, UInt32, IntPtr, Guid) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna o CLSID de um construtor específico dado uma ID de categoria de componente (CATID).
public:
int MapBuilderCATIDToCLSID(Guid % rguidBuilder, System::UInt32 dwPromptOpt, IntPtr hwndPromptOwner, [Runtime::InteropServices::Out] Guid % pclsidBuilder);
public int MapBuilderCATIDToCLSID (ref Guid rguidBuilder, uint dwPromptOpt, IntPtr hwndPromptOwner, out Guid pclsidBuilder);
abstract member MapBuilderCATIDToCLSID : Guid * uint32 * nativeint * Guid -> int
Public Function MapBuilderCATIDToCLSID (ByRef rguidBuilder As Guid, dwPromptOpt As UInteger, hwndPromptOwner As IntPtr, ByRef pclsidBuilder As Guid) As Integer
Parâmetros
- rguidBuilder
- Guid
no O CATID de um construtor. Se o GUID for um CLSID de um construtor específico e IBuilderWizardManager oferecer suporte a esse construtor, esse método retornará S_OK e definirá pclsidBuilder como rguidBuilder .
- dwPromptOpt
- UInt32
no Sinalizadores de bits que controlam se há um prompt do usuário para escolher o construtor. Os valores são obtidos da BLDPROMPTOPT enumeração.
- hwndPromptOwner
- IntPtr
no HWND de proprietário para todas as caixas de diálogo e janelas. Pode ser NULL. Se NULL, IBuilderWizardManager usará o HWND para a janela do quadro do aplicativo. Observação esse método pode abrir uma caixa de diálogo modal solicitando que o usuário escolha o Construtor a ser usado.
- pclsidBuilder
- Guid
fora O CLSID de um construtor específico.
Retornos
S_OK se o CATID mapeia para um construtor. S_FALSE se não houver nenhum construtor para o CATID.
Comentários
O chamador pode controlar se há um prompt do usuário para escolher entre vários construtores disponíveis para um CATID específico. Se não houver nenhum prompt e houver mais de um construtor disponível, então, IBuilderWizardManager Selecione um construtor padrão.
A maioria dos clientes não precisa chamar esse método diretamente. Eles podem chamar GetBuilder com o sinalizador BLDGETOPT_FAUTOMAPGUID. Chamadores avançados talvez queiram recuperar o CLSID para um construtor em vez de instanciar imediatamente o construtor.
A implementação do Gerenciador do construtor de MapBuilderCATIDToCLSID pode ter conhecimento particular de como fazer o mapeamento para CATIDs especiais ou pode usar um mecanismo geral que examina o registro.
Esse método sempre retorna o CLSID de um construtor específico.