IDebugControl::GetProcessorTypeNames method (dbgeng.h)

The GetProcessorTypeNames method returns the full name and abbreviated name of the specified processor type.

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
);

Parameters

[in] Type

Specifies the type of the processor whose name is requested. See GetActualProcessorType for a list of possible values.

[out, optional] FullNameBuffer

Receives the full name of the processor type. If FullNameBuffer is NULL, this information is not returned.

[in] FullNameBufferSize

Specifies the size, in characters, of the buffer that FullNameBuffer specifies. This size includes the space for the '\0' terminating character.

[out, optional] FullNameSize

Receives the size in characters of the full name of the processor type. This size includes the space for the '\0' terminating character. If FullNameSize is NULL, this information is not returned.

[out, optional] AbbrevNameBuffer

Receives the abbreviated name of the processor type. If AbbrevNameBuffer is NULL, this information is not returned.

[in] AbbrevNameBufferSize

Specifies the size, in characters, of the buffer that AbbrevNameBuffer specifies. This size includes the space for the '\0' terminating character.

[out, optional] AbbrevNameSize

Receives the size in characters of the abbreviated name of the processor type. This size includes the space for the '\0' terminating character. If AbbrevNameSize is NULL, this information is not returned.

Return value

This method may also return error values. See Return Values for more details.

Return code Description
S_OK
The method was successful.
S_FALSE
The method was successful. However, at least one of FullNameBuffer or AbbrevNameBuffer was too small for the corresponding name, so the name was truncated.

Remarks

For more information, see Target Information.

Requirements

Requirement Value
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)

See also

GetSupportedProcessorTypes

IDebugControl

IDebugControl2

IDebugControl3