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 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 noms de membre qui diffèrent uniquement par leur casse sont « même » sont dépendant de l’objet.)(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

IDispatchEx (Interface) IDispatchEx Interface
IDispatchEx::GetDispID IDispatchEx::GetDispID
IDispatchEx::GetNextDispIDIDispatchEx::GetNextDispID