IDispatchEx::DeleteMemberByDispIDIDispatchEx::DeleteMemberByDispID

Supprime un membre par DISPID.Deletes a member by DISPID.

SyntaxeSyntax

HRESULT DeleteMemberByDispID(  
    DISPID id  
);  

ParamètresParameters

id
Identificateur de membre.Member identifier. Utilise GetDispID ou GetNextDispID pour obtenir l’identificateur de dispatch.Uses GetDispID or GetNextDispID to obtain the dispatch identifier.

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 noms de membres qui diffèrent uniquement par la casse sont « même » sont dépendant d’objets).(Whether member names that differ only by case are the "same" is object-dependent.)

ExempleExample

BSTR bstrName;  
DISPID dispid;  
IDispatchEx *pdex;   
  
// Assign to pdex and bstrName  
if (SUCCEEDED(pdex->GetDispID(bstrName, fdexNameCaseSensitive, &dispid)))  
    pdex->DeleteMemberByDispID(dispid);  

Voir aussiSee Also

Interface IDispatchEx IDispatchEx Interface
IDispatchEx::GetDispID IDispatchEx::GetDispID
IDispatchEx::GetNextDispIDIDispatchEx::GetNextDispID