RegisterTypeLib

This function adds information about a type library to the system registry.

HRESULT RegisterTypeLib( 
  ITypeLib FAR* ptlib, 
  OLECHAR FAR* szFullPath, 
  OLECHAR FAR* szHelpDir 
); 

Parameters

  • ptlib
    [in] Pointer to the type library being registered.
  • szFullPath
    [in] Null-terminated string that contains the fully qualified path specification for the type library being registered.
  • szHelpDir
    [in] Null-terminated string that contains the directory in which the Help file for the library being registered can be found. Can be NULL.

Return Values

The following table shows the HRESULT values that can be returned by this function.

Value Description
S_OK Success.
E_OUTOFMEMORY Out of memory.
E_INVALIDARG One or more of the arguments is invalid.
TYPE_E_IOERROR The function could not write to the file.
TYPE_E_REGISTRYACCESS The system registration database could not be opened.
TYPE_E_INVALIDSTATE The type library could not be opened.

Remarks

Passing invalid (and under some circumstances NULL) pointers to this function causes an unexpected termination of the application.

The function RegisterTypeLib can be used during application initialization to register the application's type library correctly.

In addition to filling in a complete registry entry under the type library key, RegisterTypeLib adds entries for each of the dispinterfaces and Automation-compatible interfaces, including dual interfaces. This information is required to create instances of these interfaces. Coclasses are not registered (that is, RegisterTypeLib does not write any values to the CLSID key of the coclass).

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Oleauto.h.
Link Library: Oleaut32.lib.

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.