IBuilderWizardManager.MapBuilderCATIDToCLSID(Guid, UInt32, IntPtr, Guid) Methode

Definition

Gibt die CLSID eines bestimmten Generators zurück, wenn eine Komponentenkategorie-ID (CATID) vorhanden ist.

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

Parameter

rguidBuilder
Guid

in Die CATID eines Generators. Wenn die GUID eine CLSID eines bestimmten Generators ist und IBuilderWizardManager diesen Generator unterstützt, gibt diese Methode S_OK zurück und legt pclsidBuilder auf fest rguidBuilder .

dwPromptOpt
UInt32

[in] Bitflags, die steuern, ob eine Benutzereingabeaufforderung zur Auswahl des Generators angezeigt wird. Die Werte werden der BLDPROMPTOPT-Enumeration entnommen.

hwndPromptOwner
IntPtr

[in] Besitzer HWND für alle Dialogfelder und Fenster. Kann NULL sein. Wenn NULL, verwendet IBuilderWizardManager das HWND für das Anwendungsrahmenfenster. Hinweis Diese Methode kann ein modales Dialogfeld Abrufen, in dem der Benutzer aufgefordert wird, den zu verwendenden Generator auszuwählen.

pclsidBuilder
Guid

[out] Das CLSID eines bestimmten Generators.

Gibt zurück

Int32

S_OK, wenn die CATID einem Generator zugeordnet ist. S_FALSE, wenn es keinen Generator für die CATID gibt.

Hinweise

Der Aufrufer kann steuern, ob eine Benutzereingabe Aufforderung zur Auswahl mehrerer verfügbarer Generatoren für eine bestimmte CATID vorliegt. Wenn keine Eingabeaufforderung vorhanden ist und mehr als ein Generator verfügbar ist, IBuilderWizardManager wählt einen Standard Generator aus.

Die meisten Clients müssen diese Methode nicht direkt aufzurufen. Sie können GetBuilder mit dem BLDGETOPT_FAUTOMAPGUID-Flag aufgerufen werden. Erweiterte Aufrufer möchten möglicherweise die CLSID für einen Generator abrufen, anstatt den Generator sofort zu instanziieren.

Die Implementierung von des Builder-Managers MapBuilderCATIDToCLSID kann private Kenntnisse über die Durchführung der Zuordnung für spezielle CATIDs besitzen, oder es kann ein allgemeiner Mechanismus verwendet werden, der in der Registrierung aussieht.

Diese Methode gibt immer die CLSID eines bestimmten Generators zurück.

Gilt für