Função DsGetDcSiteCoverageA (dsgetdc.h)
A função DsGetDcSiteCoverage retorna os nomes de site de todos os sites cobertos por um controlador de domínio.
Sintaxe
DSGETDCAPI DWORD DsGetDcSiteCoverageA(
[in, optional] LPCSTR ServerName,
[out] PULONG EntryCount,
[out] LPSTR **SiteNames
);
Parâmetros
[in, optional] ServerName
O valor da cadeia de caracteres terminada em nulo que especifica o nome do controlador de domínio remoto.
[out] EntryCount
Ponteiro para um valor ULONG que recebe o número de sites cobertos pelo controlador de domínio.
[out] SiteNames
Ponteiro para uma matriz de ponteiros para cadeias de caracteres terminadas em nulo que recebe os nomes do site. Para liberar o buffer retornado, chame a função NetApiBufferFree .
Retornar valor
Essa função retorna DWORD DSGETDCAPI.
Comentários
Observação
O cabeçalho dsgetdc.h define DsGetDcSiteCoverage 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 Vista |
Servidor mínimo com suporte | Windows Server 2008 |
Plataforma de Destino | Windows |
Cabeçalho | dsgetdc.h |
Biblioteca | Netapi32.lib |
DLL | Netapi32.dll |