Método IDebugControl3::GetProcessorTypeNames (dbgeng.h)

Artigo
08/07/2023

O método GetProcessorTypeNames retorna o nome completo e o nome abreviado do tipo de processador especificado.

Sintaxe

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

Parâmetros

[in] Type

Especifica o tipo do processador cujo nome é solicitado. Consulte GetActualProcessorType para obter uma lista de valores possíveis.

[out, optional] FullNameBuffer

Recebe o nome completo do tipo de processador. Se FullNameBuffer for NULL, essas informações não serão retornadas.

[in] FullNameBufferSize

Especifica o tamanho, em caracteres, do buffer especificado por FullNameBuffer . Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] FullNameSize

Recebe o tamanho em caracteres do nome completo do tipo de processador. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se FullNameSize for NULL, essas informações não serão retornadas.

[out, optional] AbbrevNameBuffer

Recebe o nome abreviado do tipo de processador. Se AbbrevNameBuffer for NULL, essas informações não serão retornadas.

[in] AbbrevNameBufferSize

Especifica o tamanho, em caracteres, do buffer especificado por AbbrevNameBuffer . Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] AbbrevNameSize

Recebe o tamanho em caracteres do nome abreviado do tipo de processador. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se AbbrevNameSize for NULL, essas informações não serão retornadas.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido. No entanto, pelo menos um de FullNameBuffer ou AbbrevNameBuffer era muito pequeno para o nome correspondente, portanto, o nome foi truncado.