ILocalRegistry3.GetClassObjectOfClsid Method

Article
04/29/2015

Returns the class object that is associated with a CLSID.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

Syntax

'Declaration
Function GetClassObjectOfClsid ( _
    ByRef clsid As Guid, _
    dwFlags As UInteger, _
    lpReserved As IntPtr, _
    ByRef riid As Guid, _
    ppvClassObject As IntPtr _
) As Integer

int GetClassObjectOfClsid(
    ref Guid clsid,
    uint dwFlags,
    IntPtr lpReserved,
    ref Guid riid,
    IntPtr ppvClassObject
)

int GetClassObjectOfClsid(
    [InAttribute] Guid% clsid, 
    [InAttribute] unsigned int dwFlags, 
    [InAttribute] IntPtr lpReserved, 
    [InAttribute] Guid% riid, 
    [InAttribute] IntPtr ppvClassObject
)

abstract GetClassObjectOfClsid : 
        clsid:Guid byref * 
        dwFlags:uint32 * 
        lpReserved:IntPtr * 
        riid:Guid byref * 
        ppvClassObject:IntPtr -> int

function GetClassObjectOfClsid(
    clsid : Guid, 
    dwFlags : uint, 
    lpReserved : IntPtr, 
    riid : Guid, 
    ppvClassObject : IntPtr
) : int

Parameters

clsid
Type: Guid%

[in] Class identifier (CLSID) of the requested object. This CLSID is associated with the data and code that is used to create the object.

dwFlags
Type: UInt32

[in] Flags that control the instance creation from the CLSCTX enumeration. Specify a value of CLSCTX_INPROC_SERVER.

lpReserved
Type: IntPtr

[in] Reserved.

riid
Type: Guid%

[in] Interface to be used to communicate with the object. For example, IID_IClassFactory.

ppvClassObject
Type: IntPtr

[in] Address of pointer variable that receives the interface pointer that is requested in riid. On successful return, ppvObj contains the requested interface pointer. On failure, ppvObj contains nulla null reference (Nothing in Visual Basic).

Return Value

Type: Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From objext.idl:

HRESULT ILocalRegistry3::GetClassObjectOfClsid(
    [in] REFCLSID clsid, 
    [in] DWORD dwFlags, 
    [in] LPVOID lpReserved, 
    [in] REFIID riid, 
    [in] void** ppvClassObject
);

Specify a value of CLSCTX_INPROC_SERVER for the dwFlags parameter to instantiate the object locally. If you do not specify this value, then the object will be instantiated globally by using CoCreateInstance.

.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.

Partager via