ITypeComp::BindType
A version of this page is also available for
4/8/2010
This method binds to the type descriptions contained within a type library.
Syntax
HRESULT BindType(
OLECHAR FAR* szName,
unsigned long lHashVal,
ITypeInfo FAR* FAR* ppTInfo,
ITypeComp FAR* FAR* ppTComp
);
Parameters
- szName
[in] Null-terminated string that contains the name to be bound.
- lHashVal
[in] Hash value for the name computed by LHashValOfName.
- ppTInfo
[out] On return, contains a pointer to a pointer to an ITypeInfo of the type to which the name was bound.
- ppTComp
[out] Passes a valid pointer, such as the address of an ITypeComp* variable.
Return Value
The following table shows the return values for this function.
| Value | Description |
|---|---|
S_OK |
Success. |
E_OUTOFMEMORY |
Out of memory. |
E_INVALIDARG |
One or more of the parameters is invalid. |
TYPE_E_IOERROR |
The function could not read from the file. |
TYPE_E_INVDATAREAD |
Invalid data. |
TYPE_E_UNSUPFORMAT |
The type library has an older format. |
TYPE_E_INVALIDSTATE |
The type library could not be opened. |
TYPE_E_AMBIGUOUSNAME |
More than one instance of this name occurs in the type library. |
Remarks
Use the function BindType for binding a type name to the ITypeInfo that describes the type. This function is invoked on the ITypeComp that is returned by ITypeLib::GetTypeComp to bind to types defined within that library. It can also be used in the future for binding to nested types.
Example
TypeComp * ptcomp;
ptemp -> BindType(szName, lhashval, &ptinfo, &ptemp)
Requirements
| Header | oaidl.h, oaidl.idl |
| Library | oleaut32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |