IDebugControl3::GetProcessorTypeNames-Methode (dbgeng.h)

Artikel
02/26/2024

Die GetProcessorTypeNames-Methode gibt den vollständigen Namen und abgekürzten Namen des angegebenen Prozessortyps zurück.

Syntax

HRESULT GetProcessorTypeNames(
  [in]            ULONG  Type,
  [out, optional] PSTR   FullNameBuffer,
  [in]            ULONG  FullNameBufferSize,
  [out, optional] PULONG FullNameSize,
  [out, optional] PSTR   AbbrevNameBuffer,
  [in]            ULONG  AbbrevNameBufferSize,
  [out, optional] PULONG AbbrevNameSize
);

Parameter

[in] Type

Gibt den Typ des Prozessors an, dessen Name angefordert wird. Eine Liste der möglichen Werte finden Sie unter GetActualProcessorType .

[out, optional] FullNameBuffer

Empfängt den vollständigen Namen des Prozessortyps. Wenn FullNameBufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] FullNameBufferSize

Gibt die Größe des Puffers in Zeichen an, den FullNameBuffer angibt. Diese Größe enthält den Leerraum für das "\0"-Endzeichen.

[out, optional] FullNameSize

Empfängt die Größe in Zeichen des vollständigen Namens des Prozessortyps. Diese Größe enthält den Leerraum für das "\0"-Endzeichen. Wenn FullNameSizeNULL ist, werden diese Informationen nicht zurückgegeben.

[out, optional] AbbrevNameBuffer

Empfängt den abgekürzten Namen des Prozessortyps. Wenn AbbrevNameBufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] AbbrevNameBufferSize

Gibt die Größe des Puffers in Zeichen an, den AbbrevNameBuffer angibt. Diese Größe enthält den Leerraum für das "\0"-Endzeichen.

[out, optional] AbbrevNameSize

Empfängt die Größe des abgekürzten Namens des Prozessortyps in Zeichen. Diese Größe enthält den Leerraum für das "\0"-Endzeichen. Wenn AbbrevNameSizenull ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Allerdings war mindestens einer von FullNameBuffer oder AbbrevNameBuffer für den entsprechenden Namen zu klein, sodass der Name abgeschnitten wurde.