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. Com êxito, recebe o tamanho do nome copiado para o buffer. Se o buffer lpNameBuffer for muito pequeno para manter o nome, a função falhará e lpnSize receberá o tamanho do buffer necessário.
Valor de retorno
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.
Observações
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | secext.h (inclua Security.h) |
| biblioteca | Secur32.lib |
| de DLL |
Secur32.dll |
| conjunto de API | ext-ms-win-secur32-translatename-l1-1-0 (introduzido no Windows 8) |