IDebugHostExtensibility3 ::ExtendHostContext, méthode (dbgmodel.h)
La méthode ExtendHostContext est utilisée par les hôtes qui prennent en charge la réception de données anciennes simples arbitraires (POD) à l’intérieur d’un contexte hôte. Cette méthode étend la notion d’un contexte hôte avec une taille spécifique de données POD.
Syntaxe
HRESULT ExtendHostContext(
ULONG blobSize,
REFGUID identifier,
ULONG *blobId
);
Paramètres
blobSize
Variable ULONG qui indique la taille de l’objet blob de données à stocker dans le contexte hôte. identificateur
identifier
Valeur REFGUID qui fournit un identificateur pour le contexte hôte qui est étendu.
blobId
Pointeur vers une variable ULONG de sortie utilisée pour recevoir un identificateur unique qui peut être utilisé pour définir et récupérer les données sur n’importe quel objet de contexte hôte.
Valeur de retour
Si la méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Les données stockées à l’intérieur d’un contexte hôte doivent être des données intrinsèques simples : il ne peut pas s’agir d’une interface COM ; il ne peut pas être quelque chose qui nécessite la destruction, et il devrait être aussi petit que possible.
Sauf si les données sont explicitement ajoutées via l’interface IDebugHostContextExtensibility méthode, aucun contexte hôte ne contiendra de telles données.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | dbgmodel.h |