 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 the variable with the specified member identifier, or the name of the function and parameter names corresponding to the specified function identifier.
HRESULT GetNames( MEMBERID memid , BSTR FAR * rgBstrNames , unsigned int cMaxNames , unsigned int FAR * pcNames );
Parameters
- memid
- Identifier of the member whose name (or names) is to be returned.
- rgBstrNames
- Pointer to the caller-allocated array. On return, each of these lpcNameelements is filled in to point to a BSTRthat contains the name (or names) associated with the member.
- cMaxNames
- Length of the passed-in rgBstrNamesarray.
- pcNames
- On return, pointer to the number that represents the number of
names in
rgBstrNamesarray.
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. 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. TYPE_E_ELEMENTNOTFOUND The element was not found. Remarks
The caller must release the returned BSTRarray.
If the member identifier identifies a property that is implemented with property functions, the property name is returned.
For property getfunctions, the names of the function and its parameters are always returned.
For property put and put reference functions, the right side of the assignment is unnamed. If cMaxNamesis less than is required to return all of the names of the parameters of a function, then only the names of the first cMaxNames–1 parameters are returned. The names of the parameters are returned in the array in the same order that they appear elsewhere in the interface (for example, the same order in the parameter array associated with the FUNCDESCenumeration).
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.
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.