IDispatchEx::DeleteMemberByNameIDispatchEx::DeleteMemberByName
- 2 minutes de lecture
-
Contributeurs
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);