IDebugHostExtensibility3::ExtendHostContext-Methode (dbgmodel.h)
Die ExtendHostContext-Methode wird von Hosts verwendet, die das Empfangen beliebiger einfacher alter Daten (POD) innerhalb eines Hostkontexts unterstützen. Diese Methode erweitert den Begriff eines Hostkontexts mit einer bestimmten Größe von POD-Daten.
Syntax
HRESULT ExtendHostContext(
ULONG blobSize,
REFGUID identifier,
ULONG *blobId
);
Parameter
blobSize
Eine ULONG-Variable, die die Größe des Daten-BLOB angibt, das im Hostkontext gespeichert werden soll. Bezeichner
identifier
Ein REFGUID-Wert, der einen Bezeichner für den Hostkontext bereitstellt, der erweitert wird.
blobId
Ein Zeiger auf eine ULONG-Ausgabevariable, die zum Empfangen eines eindeutigen Bezeichners verwendet wird, mit dem die Daten für jedes Hostkontextobjekt festgelegt und abgerufen werden können.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Bemerkungen
Die in einem Hostkontext gespeicherten Daten müssen einfache systeminterne Daten sein: Es kann keine COM-Schnittstelle sein; es kann nichts sein, das Zerstörung erfordert, und es sollte so klein wie möglich sein.
Sofern die Daten nicht explizit über die IDebugHostContextExtensibility-Schnittstelle Methode hinzugefügt werden, enthält kein Hostkontext solche Daten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | dbgmodel.h |