ITypeInfo::GetDllEntry
A version of this page is also available for
4/8/2010
This method retrieves a description or specification of an entry point for a function in a dynamic-link library (DLL).
Syntax
HRESULT GetDllEntry(
MEMBERID memid,
INVOKEKIND invKind,
BSTR FAR* pBstrDllName,
BSTR FAR* pBstrName,
unsigned short FAR* pwOrdinal
);
Parameters
- memid
[in] Identifier of the member function whose DLL entry description is to be returned.
- invKind
[in] Specifies the kind of member identified by memid. This is important for properties, because one memid can identify up to three separate functions.
- pBstrDllName
[out] If not NULL, the function sets pBstrDllName to a Unicode string that contains the name of the DLL.
- pBstrName
[out] If not NULL, the function sets lpbstrName to a Unicode string that contains the name of the entry point. If the entry point is specified by an ordinal, *lpbstrName is set to NULL.
- pwOrdinal
[out] If not NULL, and if the function is defined by an ordinal, then pwOrdinal is set to point to the ordinal.
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. |
E_NOINTERFACE |
OLE could not find an implementation of one or more required interfaces. |
TYPE_E_ELEMENTNOTFOUND |
The element was not found. |
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_WRONGTYPEKIND |
Type mismatch. |
Remarks
The caller passes in a member identifier, which represents the member function whose entry description is desired.
If the function has a DLL entry point, the name of the DLL that contains the function, as well as its name or ordinal identifier, are placed in the passed-in pointers allocated by the caller.
If there is no DLL entry point for the function, an error is returned.
If the type description inherits from another type description, this function is recursive to the base type description, if necessary, to find the item with the requested member identifier.
The caller should use SysFreeString to free the BSTR elements referenced by pBstrName and pBstrDllName.
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 |