IBuilderWizardManager.MapBuilderCATIDToCLSID(Guid, UInt32, IntPtr, Guid) Метод

Определение

Возвращает идентификатор CLSID конкретного построителя при получении идентификатора категории компонента (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

Параметры

rguidBuilder
Guid

окне Идентификатор CATID построителя. Если GUID является идентификатором CLSID определенного построителя и IBuilderWizardManager поддерживает этот конструктор, этот метод возвращает S_OK и задает pclsidBuilder для значение rguidBuilder .

dwPromptOpt
UInt32

[in] Битовые флаги, контролирующие наличие запроса к пользователю для выбора построителя. Значения берутся из перечисления BLDPROMPTOPT.

hwndPromptOwner
IntPtr

[in] Дескриптор HWND владельца для всех диалоговых окон и окон. Может иметь значение "NULL". Если NULL, IBuilderWizardManager использует HWND для окна фрейма приложения. Обратите внимание, что этот метод может вызвать модальное диалоговое окно, предлагающее пользователю выбрать используемый построитель.

pclsidBuilder
Guid

[out] идентификатор CLSID конкретного построителя.

Возвращаемое значение

Int32

S_OK, если CATID сопоставляется с построителем. S_FALSE, если отсутствует конструктор для идентификатора CATID.

Комментарии

Вызывающий объект может контролировать, есть ли у пользователя запрос на выбор нескольких доступных сборщиков для конкретного идентификатора CATID. Если не выводится запрос и доступно более одного конструктора, то IBuilderWizardManager выбирается построитель по умолчанию.

Большинству клиентов не требуется вызывать этот метод напрямую. Они могут вызываться GetBuilder с флагом BLDGETOPT_FAUTOMAPGUID. Опытным вызывающим объектам может потребоваться получить идентификатор CLSID для построителя, а не сразу же создавать экземпляр построителя.

Реализация диспетчера построителя MapBuilderCATIDToCLSID может обладать личными знаниями о том, как выполнить сопоставление для специальных CATID или может использовать общий механизм, который выполняет поиск в реестре.

Этот метод всегда возвращает идентификатор CLSID конкретного построителя.

Применяется к