Função DsGetSiteNameA (dsgetdc.h)

A função DsGetSiteName retorna o nome do site onde reside um computador. Para um controlador de domínio (DC), o nome do site é o local do DC configurado. Para uma estação de trabalho membro ou servidor membro, o nome especifica o site de estação de trabalho conforme configurado no domínio do computador.

Sintaxe

DSGETDCAPI DWORD DsGetSiteNameA(
  [in]  LPCSTR ComputerName,
  [out] LPSTR  *SiteName
);

Parâmetros

[in] ComputerName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do servidor para enviar essa função. Um NULL implica o computador local.

[out] SiteName

Ponteiro para uma variável que recebe um ponteiro para uma cadeia de caracteres terminada em nulo especificando o local do site deste computador. Essa cadeia de caracteres é alocada pelo sistema e deve ser liberada usando a função NetApiBufferFree .

Valor retornado

Se a função retornar informações da conta, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de erro.

Comentários

A função DsGetSiteName não requer nenhum acesso específico ao domínio especificado. A função é enviada para o serviço "NetLogon" no computador especificado por ComputerName.

Observação

O cabeçalho dsgetdc.h define DsGetSiteName 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

Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	dsgetdc.h
Biblioteca	Netapi32.lib
DLL	Netapi32.dll

Confira também

Funções de serviço de diretório

Dsgetdcname

DsValidateSubnetName

NetApiBufferFree