IDispatchEx::DeleteMemberByNameIDispatchEx::DeleteMemberByName

Supprime un membre par son nom.Deletes a member by name.

SyntaxeSyntax

HRESULT DeleteMemberByName(  
   BSTR bstrName,  
   DWORD grfdex  
  

ParamètresParameters

bstrName
Nom du membre à supprimer.Name of member to be deleted.

grfdex
Détermine si le nom du membre respecte la casse.Determines if the member name is case sensitive. Cela peut prendre l’une des valeurs suivantes :This can be one of the following values:

ValeurValue SignificationMeaning
fdexNameCaseSensitivefdexNameCaseSensitive Demande que la recherche de nom faire de la casse.Requests that the name lookup be done in a case-sensitive manner. Peut être ignoré par l’objet qui ne prend pas en charge la recherche qui respecte la casse.Can be ignored by object that does not support case-sensitive lookup.
fdexNameCaseInsensitivefdexNameCaseInsensitive Demande que la recherche de nom faire respecter la casse.Requests that the name lookup be done in a case-insensitive manner. Peut être ignoré par l’objet qui ne prend pas en charge la recherche sans respecter la casse.Can be ignored by object that does not support case-insensitive lookup.

Valeur de retourReturn Value

Retourne l’une des valeurs suivantes :Returns one of the following values:

S_OK Opération réussie.Success.
S_FALSE Membre existe mais ne peut pas être supprimé.Member exists but cannot be deleted.

RemarquesRemarks

Si le membre est supprimé, le DISPID doit rester valide pour GetNextDispID.If the member is deleted, the DISPID needs to remain valid for GetNextDispID.

Si un membre avec un nom donné est supprimé, et par la suite un membre portant le même nom est recréé, le DISPID doit être le même.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. (Si les membres qui diffèrent uniquement par leur casse sont « même » est dépendant de l’objet.)(Whether members that differ only by case are the "same" is object-dependent.)

ExempleExample

BSTR bstrName;  
IDispatchEx *pdex;  
  
// Assign to pdex and bstrName  
pdex->DeleteMemberByName(bstrName, fdexNameCaseSensitive);  

Voir aussiSee Also

Interface IDispatchExIDispatchEx Interface