Contents Index Topic Contents | ||
Previous Topic: IDispatchEx::DeleteMemberByDispID Next Topic: IDispatchEx::GetDispID |
IDispatchEx::DeleteMemberByName
HRESULT DeleteMemberByName( BSTR bstrName, DWORD grfdex );Deletes a member by name.
- Returns one of the following values:
S_OK Success. S_FALSE Member exists but cannot be deleted.
- bstrName
- Name of member to be deleted.
- grfdex
- Determines if the member name is case sensitive. This can be one of the following values:
fdexNameCaseSensitive Request that the name lookup be done in a case-sensitive manner. Can be ignored by object that does not support case-sensitive lookup. fdexNameCaseInsensitive Request that the name lookup be done in a case-insensitive manner. Can be ignored by object that does not support case-insensitive lookup. If the member is deleted, the DISPID needs to remain valid for GetNextDispID.
If a member with a given name is deleted and later a member with the same name is recreated, the DISPID should be the same. (Whether members that differ only by case are the "same" is object-dependent.)
Example
BSTR bstrName; IDispatch *pdex; // Assign to pdex and bstrName pdex->DeleteMemberByName(bstrName, fdexNameCaseSensitive);
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.