 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This method retrieves a description or specification of an entry point for a function in a dynamic-link library (DLL).
HRESULT GetDllEntry( MEMBERID memid , INVOKEKIND invKind , BSTR FAR * pBstrDllName , BSTR FAR * pBstrName , unsigned short FAR * pwOrdinal );
Parameters
- memid
- Identifier of the member function whose DLL entry description is to be returned.
- invKind
- Specifies the kind of member identified by memid. This is important for properties, because one memidcan identify up to three separate functions.
- pBstrDllName
- If not NULL, the function sets pBstrDllNameto a Unicode string that contains the name of the DLL.
- pBstrName
- If not NULL, the function sets lpbstrNameto a Unicode string that contains the name of the entry point. If the entry point is specified by an ordinal, * lpbstrNameis set to NULL.
- pwOrdinal
- If not NULL, and if the function is defined by an ordinal, then
pwOrdinalis set to point to the ordinal.
Return Values
One of the values described in the following table is returned.
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 SysFreeStringto free the BSTRs referenced by pBstrNameand pBstrDllName.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 2.0 and later Oaidl.h Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.