IDispatchEx::DeleteMemberByName


		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.

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.