IBuilderWizardManager.MapBuilderCATIDToCLSID Method
Returns the CLSID of a specific builder given a component category ID (CATID).
Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop.8.0 (in Microsoft.VisualStudio.Shell.Interop.8.0.dll)
Syntax
'Declaration
Function MapBuilderCATIDToCLSID ( _
ByRef rguidBuilder As Guid, _
dwPromptOpt As UInteger, _
hwndPromptOwner As IntPtr, _
<OutAttribute> ByRef pclsidBuilder As Guid _
) As Integer
'Usage
Dim instance As IBuilderWizardManager
Dim rguidBuilder As Guid
Dim dwPromptOpt As UInteger
Dim hwndPromptOwner As IntPtr
Dim pclsidBuilder As Guid
Dim returnValue As Integer
returnValue = instance.MapBuilderCATIDToCLSID(rguidBuilder, _
dwPromptOpt, hwndPromptOwner, pclsidBuilder)
int MapBuilderCATIDToCLSID(
ref Guid rguidBuilder,
uint dwPromptOpt,
IntPtr hwndPromptOwner,
out Guid pclsidBuilder
)
int MapBuilderCATIDToCLSID(
[InAttribute] Guid% rguidBuilder,
[InAttribute] unsigned int dwPromptOpt,
[InAttribute] IntPtr hwndPromptOwner,
[OutAttribute] Guid% pclsidBuilder
)
function MapBuilderCATIDToCLSID(
rguidBuilder : Guid,
dwPromptOpt : uint,
hwndPromptOwner : IntPtr,
pclsidBuilder : Guid
) : int
Parameters
rguidBuilder
Type: System.Guid%[in] The CATID of a builder.
If the GUID is a CLSID of a specific builder and IBuilderWizardManager supports this builder, this method returns S_OK and sets pclsidBuilder to rguidBuilder.
dwPromptOpt
Type: System.UInt32[in] Bit flags controlling whether there is a user prompt to choose the builder. Values are taken from the BLDPROMPTOPT enumeration.
hwndPromptOwner
Type: System.IntPtr[in] Owner HWND for all dialogs and windows. May be NULL. If NULL, IBuilderWizardManager uses the HWND for the application frame window.
Note This method may bring up a modal dialog asking the user to choose the builder to use.
pclsidBuilder
Type: System.Guid%[out] The CLSID of a specific builder.
Return Value
Type: System.Int32
S_OK if the CATID maps to a builder.
S_FALSE if there is no builder for the CATID.
Remarks
The caller can control whether there is a user prompt to choose among multiple available builders for a particular CATID. If there is to be no prompt and there is more than one builder available, then IBuilderWizardManager picks a default builder.
Most clients do not need to call this method directly. They can call GetBuilder with the BLDGETOPT_FAUTOMAPGUID flag. Advanced callers may want to retrieve the CLSID for a builder rather than immediately instantiating the builder.
The builder manager’s implementation of MapBuilderCATIDToCLSID may have private knowledge of how to do the mapping for special CATIDs or it may use a general mechanism that looks in the registry.
This method always returns the CLSID of a particular builder.
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.