Função GetComputerObjectNameA (secext.h)

Recupera o nome do computador local em um formato especificado.

Sintaxe

BOOLEAN SEC_ENTRY GetComputerObjectNameA(
  [in]      EXTENDED_NAME_FORMAT NameFormat,
  [out]     LPSTR                lpNameBuffer,
  [in, out] PULONG               nSize
);

Parâmetros

[in] NameFormat

O formato do nome. Esse parâmetro é um valor do tipo de enumeração EXTENDED_NAME_FORMAT. Não pode ser NameUnknown.

[out] lpNameBuffer

Um ponteiro para um buffer que recebe o nome no formato especificado.

Se esse parâmetro for NULL, a função terá êxito e o parâmetro lpnSize receberá o tamanho necessário ou a função falhará com ERROR_INSUFFICIENT_BUFFER e lpnSize receberá o tamanho necessário. O comportamento depende do valor de NameFormat e da versão do sistema operacional.

[in, out] nSize

Na entrada, especifica o tamanho do buffer lpNameBuffer , em TCHARs. Em caso de êxito, recebe o tamanho do nome copiado para o buffer. Se o buffer lpNameBuffer for muito pequeno para conter o nome, a função falhará e lpnSize receberá o tamanho do buffer necessário.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Observação

O cabeçalho secext.h define GetComputerObjectName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	secext.h (inclua Security.h)
Biblioteca	Secur32.lib
DLL	Secur32.dll
Conjunto de APIs	ext-ms-win-secur32-translatename-l1-1-0 (introduzido no Windows 8)

Confira também

EXTENDED_NAME_FORMAT

GetComputerNameEx

Funções de informações do sistema