IDispatchEx::DeleteMemberByNameIDispatchEx::DeleteMemberByName

  • 2 minutes de lecture

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:

ValueValue 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 respectant la casse.Can be ignored by object that does not support case-sensitive lookup.
fdexNameCaseInsensitivefdexNameCaseInsensitive Demande que la recherche de nom être effectuées de façon non-respect de 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 de non-respect de la casse.Can be ignored by object that does not support case-insensitive lookup.

Valeur de retourReturn Value

Retourne 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.

NotesRemarks

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 recréé ultérieurement un membre portant le même nom, 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 la casse sont « même » est dépendant d’objets).(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