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 |