IExtendedTypeLib.AddRefExtendedTypeLib Method

Article
05/06/2010

Creates an extended type library and returns a reference counted (AddRef) interface to it.

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

Syntax

'Déclaration
Function AddRefExtendedTypeLib ( _
    lpstrCtrlLibFileName As String, _
    lpstrLibNamePrepend As String, _
    ptinfoExtender As Type, _
    dwReserved As UInteger, _
    dwFlags As UInteger, _
    lpstrDirectoryName As String, _
    <OutAttribute> ByRef pptLib As ITypeLib _
) As Integer
'Utilisation
Dim instance As IExtendedTypeLib
Dim lpstrCtrlLibFileName As String
Dim lpstrLibNamePrepend As String
Dim ptinfoExtender As Type
Dim dwReserved As UInteger
Dim dwFlags As UInteger
Dim lpstrDirectoryName As String
Dim pptLib As ITypeLib
Dim returnValue As Integer

returnValue = instance.AddRefExtendedTypeLib(lpstrCtrlLibFileName, _
    lpstrLibNamePrepend, ptinfoExtender, _
    dwReserved, dwFlags, lpstrDirectoryName, _
    pptLib)

int AddRefExtendedTypeLib(
    string lpstrCtrlLibFileName,
    string lpstrLibNamePrepend,
    Type ptinfoExtender,
    uint dwReserved,
    uint dwFlags,
    string lpstrDirectoryName,
    out ITypeLib pptLib
)

int AddRefExtendedTypeLib(
    [InAttribute] String^ lpstrCtrlLibFileName, 
    [InAttribute] String^ lpstrLibNamePrepend, 
    [InAttribute] Type^ ptinfoExtender, 
    [InAttribute] unsigned int dwReserved, 
    [InAttribute] unsigned int dwFlags, 
    [InAttribute] String^ lpstrDirectoryName, 
    [OutAttribute] ITypeLib^% pptLib
)

abstract AddRefExtendedTypeLib : 
        lpstrCtrlLibFileName:string * 
        lpstrLibNamePrepend:string * 
        ptinfoExtender:Type * 
        dwReserved:uint32 * 
        dwFlags:uint32 * 
        lpstrDirectoryName:string * 
        pptLib:ITypeLib byref -> int

function AddRefExtendedTypeLib(
    lpstrCtrlLibFileName : String, 
    lpstrLibNamePrepend : String, 
    ptinfoExtender : Type, 
    dwReserved : uint, 
    dwFlags : uint, 
    lpstrDirectoryName : String, 
    pptLib : ITypeLib
) : int

Parameters

lpstrCtrlLibFileName
Type: System.String
[in] Pointer to a string containing the type library file name. This is the type library being extended.
You can get the name of a type library from its GUID and other information using QueryPathOfRegTypeLib.

lpstrLibNamePrepend
Type: System.String
[in] Pointer to a string to prepend to the file name of the extended type library.

ptinfoExtender
Type: System.Type
[in] Pointer to the ITypeInfo used as the extender.

dwReserved
Type: System.UInt32
[in] Value not used. Use zero (0).

dwFlags
Type: System.UInt32
[in] Value not used. Use zero (0).

lpstrDirectoryName
Type: System.String
[in] Pointer to a string containing the complete path to write out the extended type library. Use NULL if not saving the library.

pptLib
Type: Microsoft.VisualStudio.OLE.Interop.ITypeLib%
[out] Pointer to the ITypeLib of the extended (combined) type library.

Return Value

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

Remarks

COM Signature

From objext.idl:

[C++]

HRESULT IExtendedTypeLib::AddRefExtendedTypeLib(
   [in] LPCOLESTR lpstrCtrlLibFileName, 
   [in] LPCOLESTR lpstrLibNamePrepend, 
   [in] ITypeInfo* ptinfoExtender, 
   [in] DWORD dwReserved, 
   [in] DWORD dwFlags, 
   [in] LPCOLESTR lpstrDirectoryName, 
   [out] ITypeLib** pptLib
);

.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