IDebugProperty3::GetCustomViewerList

Artikel
01/12/2024

Ruft eine Liste der benutzerdefinierten Viewer ab, die dieser Eigenschaft zugeordnet sind.

Syntax

int GetCustomViewerList(
    uint                  celtSkip,
    uint                  celtRequested,
    DEBUG_CUSTOM_VIEWER[] rgViewers,
    out uint              pceltFetched
);

HRESULT GetCustomViewerList(
    ULONG                celtSkip,
    ULONG                celtRequested,
    DEBUG_CUSTOM_VIEWER* rgViewers,
    ULONG*               pceltFetched
);

Parameter

celtSkip
[in] Die Anzahl der Zugänge, die übersprungen werden sollen.

celtRequested
[in] Die Anzahl der abzurufenden Viewer (gibt auch die Größe des rgViewers Arrays an).

rgViewers
[in, out] Array von DEBUG_CUSTOM_VIEWER Strukturen, die ausgefüllt werden sollen.

pceltFetched
[out] Die tatsächliche Anzahl der zurückgegebenen Viewer.

Rückgabewert

Wenn die Ausführung erfolgreich ist, wird S_OK, andernfalls ein Fehlercode zurückgegeben.

Hinweise

Um Typschnellansichten zu unterstützen, leitet diese Methode den Aufruf der GetCustomViewerList-Methode weiter. Wenn der Ausdrucksauswert auch benutzerdefinierte Viewer für den Typ dieser Eigenschaft unterstützt, kann diese Methode die entsprechenden benutzerdefinierten Viewer an die Liste anfügen.

Ausführliche Informationen zu den Unterschieden zwischen Typschnellansichten und benutzerdefinierten Viewern finden Sie unter "Type Visualizer" und "Custom Viewer ".

Beispiel

Das folgende Beispiel zeigt, wie Sie diese Methode für ein CProperty-Objekt implementieren, das die IDebugProperty3-Schnittstelle verfügbar macht.

STDMETHODIMP CProperty::GetCustomViewerList(ULONG celtSkip, ULONG celtRequested, DEBUG_CUSTOM_VIEWER* prgViewers, ULONG* pceltFetched)
{
    if (NULL == prgViewers)
    {
        return E_POINTER;
    }

    if (GetVisualizerService())
    {
        return m_pIEEVisualizerService->GetCustomViewerList(celtSkip, celtRequested, prgViewers, pceltFetched);
    }
    else
    {
        return E_NOTIMPL;
    }
}

Freigeben über