Função DsGetSiteNameA (dsgetdc.h)
A função DsGetSiteName retorna o nome do site em que um computador reside. 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 da 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. Uma NULL
[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
Valor de retorno
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.
Observações
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 pelo ComputerName.
Nota
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 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 Vista |
| servidor com suporte mínimo | Windows Server 2008 |
| da Plataforma de Destino |
Windows |
| cabeçalho | dsgetdc.h |
| biblioteca | Netapi32.lib |
| de DLL |
Netapi32.dll |
Consulte também
Funções de serviço de diretório
NetApiBufferFree