IBuilderWizardManager.MapBuilderCATIDToCLSID(Guid, UInt32, IntPtr, Guid) Método

Definição

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

Int32

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.

Aplica-se a